萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

解决 PHP 导出 CSV 中文乱码:BOM 头方案与编码转换方案对比

乱码根因

Excel 打开 UTF-8 CSV 时,若无 BOM (Byte Order Mark: EF BB BF),会按系统默认编码(中文 Windows 为 GBK)解码,导致中文乱码。记事本/CSV 编辑器通常能自动检测 UTF-8 无 BOM 正常显示。

方案一:写入 UTF-8 BOM(最简单,Excel 完美识别)

<?php
$file = fopen('export.csv', 'w');
// 写入 BOM
fwrite($file, "\xEF\xBB\xBF"); // 或 chr(0xEF).chr(0xBB).chr(0xBF)

$headers = array('ID', '姓名', '邮箱');
fputcsv($file, $headers);

$data = array(
    array(1, '张三', 'zhang@example.com'),
    array(2, '李四', 'li@example.com'),
);
foreach ($data as $row) {
    fputcsv($file, $row);
}
fclose($file);

方案二:转为 GBK/GB2312 编码(兼容旧版 Excel)

$fp = fopen('export_gbk.csv', 'w');
foreach ($rows as $row) {
    // 每个字段转编码
    $row = array_map(function($v) {
        return mb_convert_encoding($v, 'GBK', 'UTF-8');
    }, $row);
    fputcsv($fp, $row);
}
fclose($fp);

// 下载响应头
header('Content-Type: application/csv; charset=GBK');
header('Content-Disposition: attachment; filename="export.csv"');
readfile('export_gbk.csv');

方案三:使用 PHP 标准库 League\Csv(推荐现代项目)


// composer require league/csv
use League\Csv\Writer;

$csv = Writer::createFromFileObject(new SplTempFileObject());
$csv->setOutputBOM(Writer::BOM_UTF8); // 自动加 BOM
$csv->insertOne(['ID', '姓名', '邮箱']);
$csv->insertAll($data);

header('Content-Type: text/csv; charset=UTF-8');
header('Content-Disposition: attachment; filename="export.csv"');
$csv->output('export.csv');

对比总结

方案优点缺点适用场景
UTF-8 + BOM代码最少,Excel 2016+ 完美支持极老版本 Excel 可能不识别 BOM现代办公环境首选
GBK 转码兼容所有中文 Excel 版本需逐字段转码,性能稍差;不支持生僻字/Emoji老旧系统、政府/银行导出
League\Csv功能全(分块、转换、验证),自动 BOM引入依赖新项目、复杂导出

大文件导出内存优化

// 生成器分块输出,避免内存溢出
function exportLargeCsv() {
    header('Content-Type: text/csv; charset=UTF-8');
    header('Content-Disposition: attachment; filename="big.csv"');
    echo "\xEF\xBB\xBF"; // BOM
    $out = fopen('php://output', 'w');
    fputcsv($out, ['ID', 'Name']);
    foreach (range(1, 1000000) as $i) {
        fputcsv($out, [$i, "Name $i"]);
        if ($i % 10000 === 0) { flush(); ob_flush(); }
    }
    fclose($out);
}
copyright © 萬盛學電腦網 all rights reserved