fgetcsv() 是读取 CSV 的唯一可靠方式,自动处理转义、包裹及特殊字符;写入用 fputcsv() 避免手动拼接;大文件需流式处理并注意 BOM、编码和内存优化。

用 fgetcsv() 读取 CSV 最稳,别用 file_get_contents() + explode()
CSV 不是纯文本,字段里可能含逗号、换行、双引号,硬切会崩。PHP 原生 fgetcsv() 自动处理转义和包裹逻辑,是唯一靠谱的读取方式。
实操要点:
- 必须用
fopen()打开文件后传给fgetcsv(),不能直接传路径 - 记得设
encoding:如果 CSV 是 UTF-8 BOM,先用mb_convert_encoding(file_get_contents($path), 'UTF-8', 'UTF-8')清掉 BOM,否则第一行字段名可能乱码 -
fgetcsv()默认分隔符是,,若遇到制表符分隔的 CSV,加第三个参数"\t" - 每调一次
fgetcsv()读一行,返回数组;到文件尾返回false,别用feof()判定循环条件,容易多读一次空行
写入 CSV 时用 fputcsv(),手动拼字符串等于埋雷
字段含逗号、双引号或换行?自己用 str_replace() 补双引号、加转义,极易漏边角情况。PHP 的 fputcsv() 内置 RFC 4180 兼容逻辑,安全又省心。
注意点:
立即学习“PHP免费学习笔记(深入)”;
- 写入前确保文件以
'w'或'a'模式打开,且资源有效(is_resource()判一下) - 数组元素本身是数字或布尔值,
fputcsv()会自动转字符串;但null写成空字符串,''也写成空字符串——二者无法区分,业务上需提前约定 - 如需 UTF-8 输出,务必在
fopen()后立即执行stream_filter_append($fp, 'convert.iconv.UTF-8/CP1252')(Windows 记事本兼容),否则中文在 Excel 里显示为乱码
大文件别全 load 到内存,用 while (false !== $row = fgetcsv($fp)) 流式处理
一个 200MB 的 CSV,用 array_map('str_getcsv', file($path)) 直接 OOM。流式读取是唯一可行方案。
关键操作:
- 用
fseek($fp, 0)可重置指针,适合需要扫两遍的场景(比如先统计行数再处理) - 每处理 1000 行后调一次
gc_collect_cycles(),防 PHP 7.4+ 中因闭包引用导致内存不释放 - 避免在循环里反复
file_put_contents($log, ..., FILE_APPEND),改用缓冲写入:攒够 100 条日志再批量写磁盘
Excel 打开乱码?不是编码问题,是缺 BOM 头
即使你确认文件是 UTF-8 编码,Excel 默认按系统 locale 解码(中文 Windows 是 GBK),所以必须加 UTF-8 BOM 才能被正确识别。
写入时补 BOM 的最小改动:
if (ftell($fp) === 0) {
fwrite($fp, "\xEF\xBB\xBF");
}
注意:\xEF\xBB\xBF 必须写在文件开头,且只写一次;如果文件已存在内容,再写就破坏数据。
这个字节序标记对 PHP 读取无影响,但能让 Excel、WPS、Numbers 等桌面软件立刻认出是 UTF-8 —— 很多人卡在这一步,折腾半天字符集转换,其实只是少写了三个字节。



















