最稳PHP原生CSV处理方案是fgetcsv和fputcsv,它们自动处理引号、转义、换行及RFC 4180兼容格式;需显式声明分隔符与引号,并手动跳过UTF-8 BOM以避免字段名异常。

用 fgetcsv 和 fputcsv 读写 CSV 最稳
PHP 原生处理 CSV,别碰 file_get_contents + explode 这种写法——字段含逗号、换行或双引号时必然崩。直接上 fgetcsv 和 fputcsv,它们专为 CSV 设计,自动处理转义和分隔符逻辑。
这两个函数底层调用 C 的 CSV 解析器,兼容 RFC 4180,能正确识别 "a,b",c,"d""e" 这类带引号、嵌套双引号、跨行字段的格式。
-
fgetcsv每次读一行,返回数组,空行返回false -
fputcsv自动加引号、转义双引号、按需换行,不手动拼字符串 - 必须用
fopen打开文件,不能传路径字符串给fgetcsv
读 CSV 时注意 BOM 和编码问题
Windows 记事本保存的 CSV 常带 UTF-8 BOM(\xEF\xBB\xBF),fgetcsv 不会自动剥离,首列字段名可能变成 "name"(开头有不可见字符),导致 $row['name'] 取不到值。
解决方法是打开前跳过 BOM:
立即学习“PHP免费学习笔记(深入)”;
微商城订单管理系统是一款基于php+mysql开发的php订单管理系统,她的特点如下: 产品特色: 支持商品规格、订单短信提醒,订单提交限制,站外调用, 批量发货/导出,数据报表,物流轨迹、免签支付等。 1、高度开源:除核心授权文件外全部开源,二开方便。 2、分布式部署:支持分布式部署、支持数据库读写分离。 3、第三方存储:支持附件腾讯云、阿里云、七牛云存储
function open_csv_for_read($path) {
$fp = fopen($path, 'r');
if ($fp === false) return false;
// 检查并跳过 UTF-8 BOM
$bom = fread($fp, 3);
if ($bom !== "\xEF\xBB\xBF") fseek($fp, 0);
return $fp;
}
$fp = open_csv_for_read('data.csv');
while (($row = fgetcsv($fp)) !== false) {
// 正常处理 $row
}
- 别用
mb_convert_encoding盲转,BOM 是字节问题,不是编码问题 - 如果源文件是 GBK/GB2312,必须用
stream_filter_append($fp, 'convert.iconv.GBK/UTF-8')转码后再读 -
fgetcsv默认按 UTF-8 解析,不处理其他编码
fputcsv 的 delimiter 和 enclosure 参数要显式传
默认用英文逗号 , 和双引号 ",但很多国产系统导出 CSV 用分号 ; 或制表符 \t,不指定参数会导致 Excel 打开错列。
常见组合:
// 导出为 Excel 兼容的分号分隔(欧洲常用) fputcsv($fp, $row, ';', '"', '\\'); // 导出为 TSV(制表符分隔,无引号,适合纯 ASCII 数据) fputcsv($fp, $row, "\t", '', ''); // 中文字段含换行时,必须保留 enclosure,否则 Excel 会把换行当新行 fputcsv($fp, ['姓名', "张三\n男"], ',', '"', '"');
- 第三个参数
$delimiter:建议始终显式传,别依赖默认值 - 第四个参数
$enclosure:双引号最安全;设为空字符串''会禁用引号,但字段含,或换行就失效 - 第五个参数
$escape:默认是双引号,即"a""b"表示a"b;若设为反斜杠,需确保数据里没裸反斜杠
大文件读写必须用流式,别 file() 全加载
CSV 文件超 10MB 时,file('x.csv') 会把整个文件读进内存,PHP 内存溢出报 Fatal error: Allowed memory size exhausted。
正确做法是边读边处理,用 fgetcsv 循环 + 显式释放变量:
$fp = fopen('big.csv', 'r');
if (!$fp) die('无法打开文件');
$headers = fgetcsv($fp); // 读标题行
while (($row = fgetcsv($fp)) !== false) {
// 处理单行,例如插入数据库、校验、转换
process_row($row, $headers);
// 主动清空大变量,尤其 row 含长文本时
unset($row);
}
fclose($fp);
- 不要在循环里拼大数组,比如
$all[] = $row,内存照样爆 - 写大文件同理:别先组装完整 CSV 字符串再
file_put_contents,而要用fputcsv逐行写 - 用
memory_get_usage(true)在循环中抽样检查内存,早发现泄漏










