php如何读写csv文件_php读写csv文件函数流程【文件】-php教程-PHP中文网

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

php如何读写csv文件_php读写csv文件函数流程【文件】

用 `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（），fgetcsv 不会自动剥离，首列字段名可能变成 "name"（开头有不可见字符），导致 $row['name'] 取不到值。

解决方法是打开前跳过 BOM：

function open_csv_for_read($path) {
    $fp = fopen($path, 'r');
    if ($fp === false) return false;
    // 检查并跳过 UTF-8 BOM
    $bom = fread($fp, 3);
    if ($bom !== "") 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 用分号 ; 或制表符，不指定参数会导致 Excel 打开错列。

excel-split

辅助处理excel表格，按列拆分大表为多个文件

下载

常见组合：

// 导出为 Excel 兼容的分号分隔（欧洲常用）
fputcsv($fp, $row, ';', '"', '\');

// 导出为 TSV（制表符分隔，无引号，适合纯 ASCII 数据）
fputcsv($fp, $row, "	", '', '');

// 中文字段含换行时，必须保留 enclosure，否则 Excel 会把换行当新行
fputcsv($fp, ['姓名', "张三
男"], ',', '"', '"');

第三个参数 $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);