php7.4文件管理实战：fputcsv将行格式化为CSV写入【实战】-php教程-PHP中文网

fputcsv导出csv乱码或错列的根本原因是未正确处理utf-8 bom、escape参数及换行符：必须写入bom头（）使excel识别utf-8，php 7.4中escape参数须显式设为空字符串''以兼容rfc 4180，且含或"的字段需预处理或依赖fputcsv自动包裹转义。

php7.4文件管理实战：fputcsv将行格式化为csv写入【实战】

fputcsv 在 PHP 7.4 中能直接写入 CSV，但默认行为在换行、转义、编码上容易出错——尤其当字段含、"、, 或中文时，不加干预大概率生成损坏文件或解析失败。

为什么 fputcsv 写出来的 CSV 打开是乱码或错列

根本原因不是函数本身，而是没控制好三件事：文件编码、字段封装逻辑、换行符处理。

PHP 脚本默认用 UTF-8 编码，但 Excel（尤其是 Windows 版）打开 CSV 时默认按 ANSI（如 GBK）解析，导致中文显示为乱码；必须在文件开头写入 BOM 头，Excel 才会识别为 UTF-8
fputcsv 默认用双引号 " 包裹字段，但若字段本身含双引号或换行符，它会自动转义（比如 "a""b"），而某些旧版 Excel 或非标准 CSV 解析器无法正确还原
Windows 系统下用户输入的若未经处理就进 fputcsv，会被当成新行起点，导致 CSV 行数错乱（一个字段被拆成多行）

fputcsv 的 escape 参数在 PHP 7.4 必须显式设为空字符串

PHP 7.4 仍支持 escape 默认值 ""，但该行为已不兼容 RFC 4180，且会导致往返读写失真（fgetcsv 读不出原样）。从 PHP 8.4 起已被弃用，PHP 7.4 项目现在就得改。

QuickBooks Mileage CSV

使用 qbo-mileage CLI 及用户凭证，从 Airtable、Outlook 或 Google Calendar 记录生成 QuickBooks Online 里程 CSV 文件。

下载

错误写法：fputcsv($fp, $row, ',', '"') —— 没传 escape，用默认 "\"，字段里出现 cd 会被写成 "cd"，再读回来变成 c + d（截断）
正确写法：fputcsv($fp, $row, ',', '"', '') —— 第 5 个参数传空字符串 ''，彻底禁用转义，只靠双引号包裹和重复引号来处理内部引号（如 "a""b"）
注意：第 5 个参数是 escape，不是第 6 个；PHP 7.4 不支持命名参数，必须按位置填满前 5 个才能控制 escape

写入含换行符的 textarea 字段要预处理

fputcsv 不会帮你“折叠”字段内的，它只负责按 CSV 规则包裹和分隔。若用户在表单中输入带换行的备注，直接写入会导致 CSV 结构崩溃。

不要用 str_replace([" ", " ", " "], ' ', $text) 简单替换为空格——会丢失格式语义
推荐统一转为后用 HTML 换行符替代：
```
str_replace("
", "<br>", $text)
```
，这样 Excel 打开虽不渲染
```
<br>
```
，但至少整字段保留在一列；导出给网页展示时可直接用
更健壮的做法：对每个字段做预处理，仅对含或 " 的字段启用包裹，其余字段不强制引号（fputcsv 内部会自动判断是否需要引号）

示例片段：

$row = array_map(function($v) {
    if (is_string($v) && (strpos($v, "
") !== false || strpos($v, '"') !== false)) {
        return str_replace(["
", "
"], "
", $v);
    }
    return $v;
}, $row);
fputcsv($fp, $row, ',', '"', ''); // 显式禁用 escape

大文件导出别用内存拼接，直接流式写入

导出 10 万行数据时，如果先 implode 成一个大字符串再 fwrite，PHP 内存会暴涨甚至 OOM。PHP 7.4 完全支持边查边写。

数据库查询用 PDO::FETCH_ASSOC 配合 yield 或分批 fetch()，每次只持有一行数据
打开文件用 fopen('php://output', 'w') 直接输出到响应体，配合 header 强制下载，避免临时文件
务必在 fopen 后立即写入 BOM：fwrite($fp, "");，否则 UTF-8 中文在 Excel 里还是乱码
每写一行检查返回值：if (fputcsv($fp, $row, ',', '"', '') === false) { die('CSV write failed'); }，避免静默失败