在PHP后端开发中，将数据库查询结果导出为表格是常见需求。很多新手直接循环输出数据行，却忽略了最关键的列标题行，导致生成的文件在Excel中打开时第一眼无法分辨字段含义。为导出表格添加列标题行，本质上就是在数据体之前先写入一行字段名，让表格具备自解释能力。本文围绕CSV与基础Excel导出场景，详细说明如何通过PHP原生函数实现规范、安全的标题行写入。
使用fputcsv写入列标题行的基础方式
PHP提供的fputcsv函数是处理CSV导出的标准工具。它接收文件句柄和数组，自动按照RFC 4180规则添加引号与分隔符，比手工拼接逗号字符串可靠得多。要添加列标题行，只需在写入数据前，先调用一次fputcsv把字段名数组写进去即可。这样生成的文件首行就是标题，后续每行对应一条记录。
下面示例从用户表取出数据，并在开头写入编号、姓名、邮箱三列标题。注意文件必须以写模式打开，且标题数组顺序要和后面数据列顺序严格一致，否则会出现错位。使用fputcsv时，如果字段内容本身含有逗号或双引号，函数会自动包裹转义，我们无需手动处理。
<?php
header('Content-Type: text/csv; charset=utf-8');
header('Content-Disposition: attachment; filename="users.csv"');
$fp = fopen('php://output', 'w');
// 列标题行
$header = array('编号', '姓名', '邮箱');
fputcsv($fp, $header);
// 模拟数据行
$data = array(
array(1, '张三', 'zhangsan@ipipp.com'),
array(2, '李四', 'lisi@ipipp.com')
);
foreach ($data as $row) {
fputcsv($fp, $row);
}
fclose($fp);
?>
这种写法逻辑清晰，适用于绝大多数后台导出功能。其优点是不依赖任何第三方库，纯PHP环境即可运行；缺点是对Excel打开时的中文编码支持不够友好，在部分Windows环境下可能乱码，需要配合BOM头解决，后文会详细说明。
解决中文列标题在Excel中的乱码问题
当列标题包含中文时，如果直接输出UTF-8编码的CSV，Excel在双击打开时常会识别为ANSI而导致乱码。根本原因是Excel依据文件头判断是否含BOM，无BOM的UTF-8文本会被误判。解决办法是在调用fputcsv写标题之前，先向输出流写入一个UTF-8 BOM头，即字节序列EF BB BF。
在PHP中可以用fwrite写入BOM，然后再用fputcsv写标题行。这样Excel就能正确识别编码，中文列名如“编号”“姓名”可正常显示。需要注意BOM只写一次，若每个单元格都加BOM反而破坏结构。另外，若使用iconv转码为GBK也可规避乱码，但会丧失跨平台一致性，推荐优先用BOM方案。
<?php
header('Content-Type: text/csv; charset=utf-8');
header('Content-Disposition: attachment; filename="report.csv"');
$fp = fopen('php://output', 'w');
// 写入BOM头
fwrite($fp, "xEFxBBxBF");
// 中文列标题
$header = array('订单号', '客户名称', '成交金额');
fputcsv($fp, $header);
$rows = array(
array('A1001', '王五', 2300),
array('A1002', '赵六', 1890)
);
foreach ($rows as $r) {
fputcsv($fp, $r);
}
fclose($fp);
?>
对比不加BOM的版本，加BOM后文件在中文Windows的Excel中打开准确率明显提升。不过如果目标用户多用Mac或在线表格工具，BOM有时会被显示为多余字符，此时可改为输出无BOM的UTF-8并引导用户用导入功能，而非双击打开。实际项目中应根据用户环境做取舍。
导出多表格与动态列标题的进阶处理
业务系统常遇到列不固定的情况，比如管理员可配置导出字段。此时列标题行不能写死，而应由字段映射数组动态生成。我们可以先定义$columns为键名到中文标题的映射，再依据用户选择抽取对应标题与值，保证标题与数据始终同步，避免手工维护两份列表导致不一致。
另一种场景是一个文件含多个数据块，每块各有标题。这时只需在每段数据前重复写入该段的标题行即可，fputcsv可任意次数调用。若需要真正多Sheet的Excel，则CSV无能为力，应改用PhpSpreadsheet等库，通过setCellValue在首行写标题并合并样式。但就轻量导出而言，动态标题配合CSV已覆盖大部分后台需求。
<?php
header('Content-Type: text/csv; charset=utf-8');
header('Content-Disposition: attachment; filename="dynamic.csv"');
$fp = fopen('php://output', 'w');
fwrite($fp, "xEFxBBxBF");
// 字段映射
$map = array(
'id' => '编号',
'name' => '名称',
'created_at' => '创建时间'
);
// 用户选定字段
$selected = array('id', 'name');
$header = array();
foreach ($selected as $k) {
$header[] = $map[$k];
}
fputcsv($fp, $header);
$records = array(
array('id' => 1, 'name' => '项目甲', 'created_at' => '2023-01-01'),
array('id' => 2, 'name' => '项目乙', 'created_at' => '2023-02-01')
);
foreach ($records as $rec) {
$line = array();
foreach ($selected as $k) {
$line[] = $rec[$k];
}
fputcsv($fp, $line);
}
fclose($fp);
?>
上述动态方案把标题定义为配置，大幅降低后期增减字段的成本。若未来接入PhpSpreadsheet，只需把fputcsv替换为单元格写入，标题逻辑可复用。总结来看，无论简单还是复杂导出，核心原则都是先规划标题行结构，再让数据严格对齐，这是保障表格可用性的第一步。