如何在 PHP 中实现简单的数据导出到 Excel_使用 header 强制导出 CSV-php教程-PHP中文网

用header导出csv而非excel是因为php原生不支持生成真正的.xlsx文件，csv方案更轻量、兼容性更好；必须添加utf-8 bom（\xef\xbb\xbf）以避免windows版excel中文乱码；fputcsv可自动处理特殊字符转义，但需以数组形式传入字段，严禁手动拼接字符串。

如何在 php 中实现简单的数据导出到 excel_使用 header 强制导出 csv

为什么用 `header` 导出 CSV 而不是 Excel 文件

PHP 本身不生成真正的 .xlsx 文件，所谓“导出 Excel”在简单场景下基本等于“导出 CSV 并让浏览器用 Excel 打开”。header('Content-Type: text/csv') 配合正确的分隔符和编码，是最快、最轻量、兼容性最好的方案。Excel、WPS、Numbers 都能正常识别 UTF-8 编码的 CSV，前提是 BOM 头处理得当。

导出 CSV 必须加 UTF-8 BOM 吗

必须加，否则中文在 Windows 版 Excel 中大概率显示为乱码。Excel 默认用 ANSI（如 GBK）解析无 BOM 的 UTF-8 CSV，而其他系统（macOS/Linux）通常能自动识别。BOM 是三个字节 \xEF\xBB\xBF，必须在输出任何内容前写入。

不要用 echo "\xEF\xBB\xBF" 后再 echo 数据 —— 如果之前有空格、换行或 session_start() 输出了 cookie，BOM 就失效
推荐方式：fpassthru(fopen('php://output', 'w')) 前先 fputs($fp, "\xEF\xBB\xBF")，或更稳妥地用 fputcsv + fopen('php://output', 'w') 手动写 BOM
注意：BOM 只对 UTF-8 有效；如果你用的是 GBK，就别加，但也不建议用 GBK —— 现代 PHP 环境默认 UTF-8

`fputcsv` 的坑：字段含逗号、换行、双引号怎么处理

fputcsv 会自动转义，但前提是字段是数组元素，且你没手动拼接字符串。常见错误是把整行拼成一个字符串再 echo，结果换行符被 Excel 当成新行，破坏结构。

Miller CSV TSV JSON 数据处理器

Miller (mlr) 是一个命令行工具，用于查询、整形和重新格式化名称索引数据，如 CSV、TSV、JSON 和 JSON Lines。它将 awk、sed、cut、join 和 sort 的功能整合到一个专为结构化数据处理而构建的单一工具中。

下载

正确做法：每行数据作为数组传给 fputcsv($fp, $row)，例如 ['张三', '运维部', "备注：需跟进\n2024-05"]
fputcsv 默认用双引号包裹含逗号/换行/双引号的字段，并将字段内双引号转义为两个双引号（Excel 兼容标准）
不要改 $delimiter 为中文逗号（如“，”）—— Excel 不认，会当成单字段
如果字段里有 HTML 标签或特殊符号，建议提前用 strip_tags() 或 htmlspecialchars_decode() 清理，避免导出后格式错乱

完整可运行的最小导出示例

header('Content-Type: text/csv; charset=utf-8');
header('Content-Disposition: attachment; filename="export_' . date('Y-m-d') . '.csv"');
header('Pragma: no-cache');
header('Expires: 0');

$fp = fopen('php://output', 'w');
fputs($fp, "\xEF\xBB\xBF"); // 写入 BOM

// 表头
fputcsv($fp, ['姓名', '部门', '入职日期', '备注']);

// 数据行（实际中从数据库 fetch）
$rows = [
    ['张三', '技术部', '2023-01-15', "试用期已过\n绩效A"],
    ['李四', '产品部', '2023-03-22', '远程办公'],
];
foreach ($rows as $row) {
    fputcsv($fp, $row);
}

fclose($fp);
exit;

这段代码跑通的关键在于：BOM 在 fputcsv 前写入、没任何额外输出、没开启 output buffering（如有，请在开头加 ob_end_clean()）。一旦有 warning 或 notice 输出，header 就会失败，变成下载一个带错误信息的损坏 CSV。

真正麻烦的从来不是写几行 CSV，而是确保整个执行链路干净——没有 warning、没有空格、没有 session 输出、没有框架自动注入的 header。这点容易被忽略，但几乎占了线上导出失败问题的八成。