fputcsv是PHP导出CSV最稳妥方案,自动转义特殊字符;需用'w'模式打开、写BOM防中文乱码、确保索引数组、流式处理大数据并正确设置HTTP头。

用 fputcsv 写入 CSV 文件最稳妥
PHP 原生导出 CSV,fputcsv 是唯一推荐的函数——它自动处理逗号、换行、双引号转义,不会因字段含 , 或 " 导致格式错乱。手拼字符串(比如 implode(',', $row))在真实数据里大概率崩。
实操建议:
立即学习“PHP免费学习笔记(深入)”;
- 始终用
fopen(..., 'w')打开文件,不要用'a'(追加模式),否则多次导出会叠加表头 - 写入前先调用
fputcsv($fp, $header)输出表头,字段名必须和数据顺序严格一致 - 每行数据传给
fputcsv前,确保是索引数组(['name' => 'a']要用array_values()转) - 写完必须
fclose($fp),否则文件可能不完整或被锁住
从 MySQL 查询结果直接导出 CSV
查完再遍历写入是最常见场景,但注意:不能直接把 mysqli_fetch_assoc() 的关联数组喂给 fputcsv,它只认数字键。
实操建议:
立即学习“PHP免费学习笔记(深入)”;
- 表头用
array_keys(mysqli_fetch_assoc($result))提取,再fputcsv一次 - 循环中每次用
mysqli_fetch_row($result)(返回数字索引数组),直接传给fputcsv - 如果数据量大(比如 >10 万行),别一次性
fetch_all到内存,会 OOM;保持流式读取 - 记得在输出前加 HTTP 头:
header('Content-Type: text/csv; charset=utf-8');和header('Content-Disposition: attachment; filename="data.csv"');
中文乱码?UTF-8 BOM 是关键
Excel 打开 CSV 中文变乱码,99% 是缺 UTF-8 BOM。PHP 默认输出无 BOM,Excel 会误判为 ANSI 编码。
实操建议:
立即学习“PHP免费学习笔记(深入)”;
- 在
fopen后、写入任何内容前,先写入 BOM:fwrite($fp, "\xEF\xBB\xBF"); - 不要用
mb_convert_encoding强转编码——源数据已经是 UTF-8 的话,转了反而错 - 如果数据库连的是
utf8mb4,确认连接时已执行SET NAMES utf8mb4,否则查出来就是乱码源头 - 避免用 Notepad 编辑 CSV 文件后再下载——它保存时可能偷偷改编码
导出到浏览器还是服务器文件?路径和权限别踩坑
导出目标不同,处理逻辑差异很大。很多人卡在“文件生成了但下载不了”或“下载了但打不开”,其实是路径或响应头没对上。
实操建议:
立即学习“PHP免费学习笔记(深入)”;
- 导出到浏览器:用
php://output当文件句柄,配合header控制下载行为;不能同时用readfile()又写fputcsv - 导出到服务器:路径必须写绝对路径(
/var/www/html/export/xxx.csv),相对路径容易因 CLI / Web 运行目录不同而失败 - 确保 PHP 进程有写权限(Web 服务用户如
www-data或nginx能写目标目录) - 导出后不要自动
unlink()——用户还没下载完就删了,得等异步清理或设定时任务
真正麻烦的不是语法,是字符编码、流控制、权限三者咬合的那一小段逻辑。漏掉 BOM、用错 fetch 方式、header 位置不对,都会让整个导出看起来“成功”,实际打开全错。



















