PHP 大 CSV 文件怎么逐行导入并跳过空行

PHP 处理大 CSV 时，推荐用 fopen() 打开流，再用 fgetcsv() 一次读取一条记录。不要先调用 file() 把整文件装进数组；空行要按 [null] 单独跳过，而不是用没有边界的真假判断。下面的写法保留合法的 0 值，也能处理字段内部带换行的标准 CSV。

核心做法：用 while (($row = fgetcsv($fp, null, ',', '"', '')) !== false) 流式读取，先识别空记录，再校验列数，最后把当前行交给导入逻辑。

先记住三个判断：内存由当前行决定；空 CSV 行通常是单个 null；PHP 8.4 起应显式传入 escape，需要兼容 RFC 4180 时可传空字符串。

打开文件并让 fgetcsv 逐条读取

fopen($path, 'rb') 返回文件资源或 false。读取循环应直接判断 fgetcsv() 的返回值，这样最后一行不会被重复处理，也不会把 feof() 的状态误当成“下一条数据已存在”。

这里把长度参数写成 null，表示不限制最大行长，适合无法预估列内容的导入任务；如果业务能确定最长记录，也可以传一个足够大的整数。逗号、双引号和空转义字符应与文件协议保持一致，不能只依赖默认值。

识别空行并跳过无效记录

官方手册明确说明，CSV 中的空行会返回只含一个 null 的数组。因此，先判断 $row === [null]。如果某些文件会出现“逗号很多但每个字段都是空白”的记录，再做一次字段级检查。不要直接写 if (!$row)，否则无法表达字段语义，也容易把合法的零值处理错。

function isBlankCsvRow(array $row): bool
{
    if ($row === [null]) {
        return true;
    }

    foreach ($row as $value) {
        if ($value !== null && trim((string) $value) !== '') {
            return false;
        }
    }

    return true;
}

while (($row = fgetcsv($fp, null, ',', '"', '')) !== false) {
    if (isBlankCsvRow($row)) {
        continue;
    }
    // 空记录之外，0、0.00 和 "0" 都会继续保留
}

把表头映射到字段并处理数据

如果第一行是表头，可以只保存这一行，后续用 array_combine() 生成关联数组。调用前必须检查列数，否则缺列时会得到错误或错位数据。大文件场景下，处理完一行就写入数据库、消息队列或批量缓冲区，不要再把所有行追加到 $rows。

$header = null;
$line = 0;

while (($row = fgetcsv($fp, null, ',', '"', '')) !== false) {
    $line++;
    if (isBlankCsvRow($row)) {
        continue;
    }

    if ($header === null) {
        $header = array_map(
            static fn ($value) => trim((string) $value),
            $row
        );
        continue;
    }

    if (count($row) !== count($header)) {
        error_log("第 {$line} 行列数不一致");
        continue;
    }

    $record = array_combine($header, $row);
    // 例如：导入 $record['order_id']，完成后释放本行引用
}

表头带 UTF-8 BOM 时，第一列名称可能多出不可见字节，可在读取第一行后针对首字段移除 BOM。编码转换也应放在文件边界处理，不要把 CSV 语法拆成 explode(',')；被双引号包住的字段可能包含逗号，甚至包含换行。

处理 CSV 的边界情况

如果生产文件的分隔符不是逗号，只需同步替换第三个参数；分隔符、包围符和 escape 都必须是单字节字符或符合手册要求的空字符串。导入失败行建议记录行号和原因，继续处理后续数据，是否回滚由业务事务边界决定。

常见问题

为什么不用 file() 读取大 CSV？

file() 会先建立包含整文件行内容的数组，数据量大时内存压力明显。fopen() 加 fgetcsv() 只保留当前记录，更适合边读边处理。

空行能不能用 array_filter($row) 过滤？

不建议把它作为整行规则。array_filter() 默认会移除 PHP 认为为空的值，其中包括 0、'0' 和空字符串；CSV 导入应先识别单 null 空行，再按业务决定空字段是否合法。

fgetcsv 会不会把引号内换行拆成多条记录？

符合 CSV 包围规则时，解析器会继续读取直到字段包围结束；因此应让 fgetcsv() 负责解析，不要用按换行切割的方式替代它。

参考资料：PHP fgetcsv 手册、PHP fopen 手册、PHP feof 手册、PHP array_filter 手册。