PHP fgetcsv 怎样保留引号字段中的换行

CSV 里的换行不一定代表一条记录结束：如果换行位于一对完整的引号字段中，它就是字段内容的一部分。用 PHP 读取这类文件时，不要先用 fgets() 按物理行切开，再自己拼接；应让 fgetcsv() 根据 enclosure 判断记录边界。

官方文档：https://www.php.net/manual/zh/function.fgetcsv.php

只要多行字段的引号是成对闭合的，fgetcsv() 会继续读取后续物理行，直到找到不在引号中的记录换行。关键是不要提前把输入按换行符拆碎，并显式传入 CSV 参数。

先区分字段换行和记录换行

下面这段 CSV 有三条记录，第二条记录的第一个字段包含两次换行。它在文本上占了多行，但逻辑上仍然只有一条记录：

name,description
alpha,"第一段说明
第二段说明"
beta,"单行说明"

判断边界时看的是引号状态，而不是简单数换行符。直接对文件调用 fgetcsv()，解析器会把第二条记录的两行描述放进同一个字段；如果先用 fgets() 读取，每一行就会失去 CSV 的上下文。

用 fgetcsv 读取并保留多行字段

读取时把文件指针交给 fgetcsv()，并明确分隔符、包围符和转义参数。PHP 8.4 起，依赖 escape 的默认值已被弃用，因此示例直接传入空字符串，表示不启用非标准的反斜杠转义；字段中的引号使用 CSV 约定的连续两个包围符表示。

这里的 length 使用 null，代表不人为设置最大行长度；如果必须设置上限，它应大于 CSV 中可能出现的最长记录，否则记录可能被拆成块。示例使用 rb 打开文件，避免平台换行转换干扰原始内容。

为什么不要自己按换行符拼接

手动拼接通常会遇到三个问题：无法可靠判断引号是否闭合；字段中的换行会与下一条记录的换行混在一起；包含逗号或双引号的字段还需要同时处理转义。fgetcsv() 返回的是字段数组，调用者只需处理字段数量、空行和 false 三种边界。

遇到异常时先检查这四项

• 引号是否闭合：缺少结束包围符时，解析器会继续寻找后续内容，结果可能看起来像多条记录被合并。
• 是否提前 fgets：不要先按物理行读取，再把字符串交给解析器；那样会丢失跨行字段的上下文。
• length 是否过小：设置长度时要覆盖完整记录，而不是只覆盖普通单行字段。
• escape 是否明确：PHP 8.4 起不要依赖默认 escape；标准 CSV 场景可显式传入空字符串，并用连续引号表示字段内引号。

相关问题

字段中的换行会不会生成两条数组记录？不会，只要换行处于成对的 enclosure 内，多个物理行仍会组成一个逻辑记录。

能不能用 str_getcsv 处理字符串？可以，但如果输入来自文件并且包含跨行字段，直接把文件指针交给 fgetcsv() 更容易保留完整上下文。

为什么结果里有 null？空 CSV 行会返回包含单个 null 字段的数组，它不是读取失败；真正的失败或结束应按 false 分支处理。