如何基于PHP while循环生成CSV文件并保存至指定目录？

前期问题修正 #

你现有代码存在两个会导致运行异常的问题，需要先修正：

• SQL查询的字段是count，但循环内取值用的是quantity，字段名不匹配会取不到值；同时count是MySQL保留字，查询时需要加反引号避免语法错误。
• 原代码仅遍历了结果集，没有做任何CSV文件的写入逻辑。

核心实现步骤 #

• 预先定义CSV文件保存的绝对目录，自动检测目录是否存在，不存在则递归创建，避免路径不存在导致写入失败。
• 通过PHP文件操作函数打开指定的本地文件句柄，获取写入权限。
• 结合PHP内置的fputcsv()函数逐行将数据库查询结果写入文件，该函数会自动处理CSV格式的转义逻辑，不需要手动拼接逗号、引号分隔的字符串。
• 所有内容写入完成后关闭文件句柄，确保内容真正落盘到服务器磁盘。

完整可运行代码示例 #

// 配置CSV保存目录，使用绝对路径避免相对路径解析错误
$saveDir = __DIR__ . '/csv_exports/';
// 目录不存在时自动创建，权限设置为0755（安全且支持web进程写入）
if (!is_dir($saveDir)) {
    mkdir($saveDir, 0755, true);
}
// 按时间戳生成独立文件名，避免覆盖历史生成的文件
$savePath = $saveDir . 'product_stock_' . date('Ymd_His') . '.csv';

// 可选设置数据库字符集，避免中文乱码
mysql_query("SET NAMES 'utf8'");
// 执行查询，对保留字段加反引号
$sql = mysql_query("SELECT `code`, `count` FROM products WHERE active = '1' ORDER BY code ASC") or die(mysql_error());

// 以写入模式打开目标文件
$fileHandle = fopen($savePath, 'w');
// 可选：写入UTF-8 BOM标识，解决Excel打开CSV中文乱码问题
fwrite($fileHandle, chr(0xEF) . chr(0xBB) . chr(0xBF));
// 写入CSV表头
fputcsv($fileHandle, ['商品编码', '库存数量']);

// 遍历结果集逐行写入
while ($row = mysql_fetch_assoc($sql)) {
    $code = $row['code'];
    $quantity = $row['count']; // 和SQL查询字段保持对应
    fputcsv($fileHandle, [$code, $quantity]);
}

// 关闭文件句柄，完成写入
fclose($fileHandle);

// 输出结果
echo "CSV文件已成功生成，保存路径：" . $savePath;

注意事项 #

• 权限配置：确保web运行用户（如www-data、apache）对保存目录有写入权限，不要设置过高的危险权限（如0777）。
• 内存优化：上述实现是逐行读取数据库、逐行写入文件，即使查询结果量很大，也不会占用过多PHP内存，适合大数据量的导出场景。
• 扩展兼容性：原代码使用的mysql_*扩展已在PHP 5.5版本废弃，PHP 7及以上版本已完全移除该扩展，有条件的建议替换为MySQLi或PDO扩展，同时防范SQL注入风险。

内容的提问来源于stack exchange，提问作者BTR383434