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

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

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

fgetcsvfputcsv 读写 CSV 最稳

PHP 原生处理 CSV,别碰 file_get_contents + explode 这种写法——字段含逗号、换行或双引号时必然崩。直接上 fgetcsvfputcsv,它们专为 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) 在循环中抽样检查内存,早发现泄漏

实际项目里,最常被忽略的是 BOM 处理和分隔符显式声明——前者让字段键名莫名多出乱码,后者让 Excel 打开后全挤在一列。这两处不修,后面逻辑再严谨也没用。

https://www.php.cn/faq/2004261.html

发表回复

Your email address will not be published. Required fields are marked *