在PHP后台开发中，经常需要把数据库查出来的关联数组整理成CSV文件，方便运营或客户用Excel打开。关联数组的键名通常对应表头，键值对应每行内容，如果手动用逗号连接字符串，一旦某个值里包含逗号、双引号或换行，生成的文件就会被Excel解析错列。PHP内置的fputcsv函数专门解决这类问题，它会按照CSV标准自动加引号并转义，开发者只需要把数组交给它即可。
一、fputcsv的基本用法
fputcsv是PHP标准库中的函数，作用是将一行数据格式化为CSV格式并写入指定的文件句柄。它的第一个参数是资源类型的文件指针，第二个参数是索引数组，函数会依次把数组元素作为单元格写入，字段之间用逗号分隔，并在需要时加上双引号。
需要注意的是，fputcsv只接受索引数组，不接受关联数组。因此当我们有一个关联数组时，必须先把它的值提取出来，或者把键和值分别处理。例如下面这段代码演示了如何把一个单条关联数组写入CSV：
<?php
// 打开内存临时流，也可以换成 fopen('test.csv', 'w')
$fp = fopen('php://memory', 'w');
// 一条关联数组记录
$row = array(
'name' => '张三',
'age' => 28,
'city' => '北京,海淀区'
);
// 提取关联数组的值变成索引数组再写入
fputcsv($fp, array_values($row));
// 将内存流指针回到开头并读取内容
rewind($fp);
echo stream_get_contents($fp);
fclose($fp);
?>
上面的代码中，city字段的值包含逗号，fputcsv会自动将其用双引号包裹，避免被误认为两列。如果手动拼接字符串，就要自己判断并加引号，非常容易出错。
二、关联数组转CSV的完整步骤
要把一组关联数组（比如从数据库取出的列表）完整导出为CSV文件，通常分为四步：打开文件句柄、写表头、遍历写数据行、关闭句柄。表头一般来自第一条记录的键名，也可以用固定的中文字段映射。
下面的示例展示了一个常见场景：把用户列表写入本地文件user.csv，首行是字段名，后面每行是用户数据。我们用array_keys获取表头，再在循环中用array_values取每行的值。
<?php
// 模拟从数据库查出的关联数组列表
$users = array(
array('id' => 1, 'name' => '李四', 'email' => 'li@ippipp.com'),
array('id' => 2, 'name' => '王五', 'email' => 'wang@ippipp.com')
);
// 1. 打开文件句柄
$fp = fopen('user.csv', 'w');
// 2. 写表头（用第一行数据的键名）
fputcsv($fp, array_keys($users[0]));
// 3. 逐行写数据
foreach ($users as $item) {
fputcsv($fp, array_values($item));
}
// 4. 关闭句柄
fclose($fp);
?>
这段代码逻辑清晰，但当字段顺序需要调整或键名是英文想换成中文表头时，直接array_keys就不够用了。此时可以自己定义表头数组，并按映射关系从关联数组中取对应的值。
例如我们想导出中文表头，可以这样做：
<?php
$users = array(
array('id' => 1, 'name' => '李四', 'email' => 'li@ipipp.com'),
array('id' => 2, 'name' => '王五', 'email' => 'wang@ipipp.com')
);
$fp = fopen('user_cn.csv', 'w');
// 自定义中文表头
fputcsv($fp, array('编号', '姓名', '邮箱'));
foreach ($users as $item) {
// 按固定顺序取出值
fputcsv($fp, array($item['id'], $item['name'], $item['email']));
}
fclose($fp);
?>
三、输出到浏览器实现文件下载
更多时候，我们不是保存成服务器文件，而是让用户点击按钮直接下载CSV。这时要把目标流换成php://output，并在输出前发送正确的HTTP头，告诉浏览器这是附件。
使用php://output时，fputcsv写入的内容会直接进到输出缓冲区，从而发送给客户端。注意要先设置header再写数据，且写完之后用exit结束脚本，防止后续输出破坏文件。
<?php
$users = array(
array('id' => 1, 'name' => '李四', 'email' => 'li@ipipp.com'),
array('id' => 2, 'name' => '王五', 'email' => 'wang@ipipp.com')
);
header('Content-Type: text/csv; charset=utf-8');
header('Content-Disposition: attachment; filename="users.csv"');
$fp = fopen('php://output', 'w');
// 解决Excel打开UTF-8乱码：写BOM头
fwrite($fp, chr(0xEF).chr(0xBB).chr(0xBF));
fputcsv($fp, array('id', 'name', 'email'));
foreach ($users as $item) {
fputcsv($fp, array_values($item));
}
fclose($fp);
exit;
?>
上面的代码里，我们在开头写入了UTF-8的BOM标记。这是因为Windows下的Excel默认用本地编码打开CSV，如果没有BOM，中文常会显示乱码。加上BOM后，Excel能正确识别为UTF-8。
四、常见误区与注意事项
一个常见误区是认为fputcsv只能写文件，其实它接受任何合法的流资源，包括内存流、输出流甚至网络流。另一个误区是忘记关联数组必须转成索引数组，若直接把关联数组传进去，PHP会只对值做格式化但键名顺序依赖内部实现，不可靠。
此外，如果数据量非常大，建议分批查询并写入，不要一次性把几万条记录读进内存再循环。可以每查出一千条就打开句柄追加写入，或者一直保持句柄打开，边查边写，这样内存占用更低，脚本也不容易超时。
| 方式 | 适用场景 | 优点 | 缺点 |
|---|---|---|---|
| 写本地文件 | 服务端生成报表 | 可重复读取、便于存档 | 占磁盘空间 |
| php://output下载 | 用户即时导出 | 不落盘、响应快 | 需控制好超时与内存 |
| php://memory | 先拼装再返回字符串 | 灵活、无文件IO | 数据量大时耗内存 |
总的来说，用fputcsv处理关联数组转CSV是PHP里最省心的方式。只要记住先开流、再写头、后写行，并根据下载或存盘选择不同流地址，就能稳定高效地完成导出任务。