如何正确导出含中文字符的 CSV 文件（PHP 实战教程）-php教程-PHP中文网

如何正确导出含中文字符的 CSV 文件（PHP 实战教程）

php 导出 csv 时中文显示为问号（???），主因是缺少 utf-8 bom 头且响应头声明不规范；本文详解如何通过添加 bom、修正 http 头及统一编码处理，确保 excel 和主流工具正确识别中文。

php 导出 csv 时中文显示为问号（???），主因是缺少 utf-8 bom 头且响应头声明不规范；本文详解如何通过添加 bom、修正 http 头及统一编码处理，确保 excel 和主流工具正确识别中文。

在 PHP 中导出含中文的 CSV 文件常遇到乱码问题——英文正常，中文却显示为 ???。这并非数据本身损坏，而是字符编码未被客户端（尤其是 Microsoft Excel）正确识别所致。核心原因有三：

缺少 UTF-8 BOM（Byte Order Mark）头，导致 Excel 默认按 ANSI（如 GBK）解析 UTF-8 字节流；
Content-Type 响应头格式错误（charset:UTF-8 应为 charset=UTF-8）；
Content-Encoding: UTF-8 是无效头（UTF-8 不是压缩编码，不应使用此头）。

✅ 正确做法如下：

✅ 1. 修正 HTTP 响应头

// ❌ 错误示例（已移除）
// header("Content-Encoding: UTF-8");           // 删除！UTF-8 不是编码方式
// header('Content-type: application/csv;charset:UTF-8'); // 格式错误

// ✅ 正确写法
header('Content-Type: text/csv; charset=UTF-8');
header('Content-Disposition: attachment; filename="' . $getrow["title"] . '_' . $_POST["year"] . '.csv"');
header('Cache-Control: no-cache');
header('Pragma: no-cache');

⚠️ 注意：Content-Type 中 charset=UTF-8 必须紧随 MIME 类型后，且使用等号 =，不能用冒号 :；application/csv 并非标准 MIME 类型，推荐使用更通用的 text/csv。

Knowledge Graph - Csv Graph Loader Generator
从 CSV 数据集生成图数据库加载器和三元组映射。将表格 CSV 数据转换为图数据库可直接使用的节点、边和三元组。

下载

✅ 2. 强制写入 UTF-8 BOM（关键步骤）

BOM（0xEF 0xBB 0xBF）是 Excel 识别 UTF-8 文件的“信号”。必须在写入任何 CSV 数据前，立即写入 BOM 到输出流：

$file = fopen('php://output', 'w');
// ✅ 写入 UTF-8 BOM（三字节签名）
fwrite($file, "\xEF\xBB\xBF");
// 或等价写法：fprintf($file, chr(0xEF) . chr(0xBB) . chr(0xBF));

// 后续写入数据（确保所有字段均为 UTF-8 编码）
foreach ($newname as $line) {
    fputcsv($file, $line); // fputcsv 自动处理字段转义，但要求输入为 UTF-8 字符串
}
fclose($file);

✅ 3. 额外保障：确保数据源为 UTF-8

数据库连接需设为 UTF-8（MySQLi 示例）：

mysqli_set_charset($db, 'utf8mb4'); // 推荐 utf8mb4（支持 emoji 及完整 Unicode）

若从 POST/GET 获取中文参数，确认页面提交编码为 UTF-8（HTML 表单 <meta charset="UTF-8"> + accept-charset="UTF-8"）。

? 完整安全示例（含防注入与编码清理）

// 1. 清洗并验证输入（防止 SQL 注入）
$code = (int)$_POST["code"];
$year = preg_replace('/[^0-9\-]/', '', $_POST["year"]);

// 2. 查询数据（使用预处理更佳）
$a = mysqli_query($db, "SELECT * FROM remark_type WHERE remark_code = $code");
$getrow = mysqli_fetch_array($a);
if (!$getrow) die('Invalid code');

// 3. 设置响应头
header('Content-Type: text/csv; charset=UTF-8');
header('Content-Disposition: attachment; filename="' . 
    rawurlencode($getrow["title"]) . '_' . $year . '.csv"');
header('Cache-Control: no-cache');
header('Pragma: no-cache');

// 4. 输出 BOM + CSV 数据
$file = fopen('php://output', 'w');
fwrite($file, "\xEF\xBB\xBF");

// 确保 $newname 中每个字符串都是 UTF-8 编码（必要时转换）
foreach ($newname as $line) {
    // 如需强制转码（例如数据来自 GBK 源）：
    // $line = array_map(fn($v) => mb_convert_encoding($v, 'UTF-8', 'GBK'), $line);
    fputcsv($file, $line);
}
fclose($file);
exit;

? 常见误区总结

问题	说明
`echo "\xEF\xBB\xBF";` 在 `fopen('php://output')` 之前	无效！BOM 必须写入到 `fopen` 打开的流中，否则可能被缓冲或截断
使用 `application/csv` MIME 类型	非标准，部分浏览器/Excel 版本兼容性差，优先用 `text/csv`
未设置数据库连接编码	即使 PHP 文件是 UTF-8，若 MySQL 返回 GBK 字节，仍会乱码
在 `fputcsv` 前手动 `echo` 其他内容	会破坏 CSV 结构，BOM 必须是文件开头唯一内容