fputcsv不能直接写入关联数组，因其仅按数字下标顺序写入字段，不识别键名；传入['name'=>'Alice','age'=>30]会因键不存在而报错或写空行，导致表头与数据错位。
PHP 关联数组不能直接用 fputcsv 写入，因为 fputcsv 只接受索引数组；必须先做键名对齐或转换，否则 CSV 表头和数据列会错位甚至丢失。
为什么直接传关联数组会出问题
fputcsv 本质是按数组下标顺序写入字段，不识别键名。如果传入 ['name' => 'Alice', 'age' => 30]，它会尝试写 0 => 'Alice', 1 => 30，但这两个键根本不存在——实际行为是写入空行或触发警告（取决于 PHP 版本和错误级别）。
- PHP 8.0+ 会报
Warning: fputcsv(): Unable to access offset - 低版本可能静默跳过，导致 CSV 内容为空或列数不一致
- 即使“侥幸”写入，表头也无法自动对应，后续 Excel 打开后字段错乱
正确写法：先定义字段顺序，再用 array_values 提取值
关键不是“怎么转数组”，而是“怎么保证每行字段顺序和表头严格一致”。推荐显式声明字段名列表，再逐行映射：
$headers = ['name', 'age', 'city'];
$fp = fopen('users.csv', 'w');
fputcsv($fp, $headers); // 先写表头
$data = [
['name' => 'Alice', 'age' => 30, 'city' => 'Beijing'],
['name' => 'Bob', 'age' => 25, 'city' => 'Shanghai']
];
foreach ($data as $row) {
$values = array_map(fn($key) => $row[$key] ?? '', $headers);
fputcsv($fp, $values);
}
fclose($fp);
-
array_map+ 匿名函数确保每行都按$headers顺序取值 -
?? ''防止缺失键导致 Notice - 不用
array_values($row)—— 它依赖数组内部顺序，而关联数组遍历顺序在 PHP 中不完全可靠（尤其经过修改后）
遇到嵌套或动态字段怎么办
如果每行字段不统一（比如有的有 email，有的没有），强行对齐会导致大量空列。这时应先扫描全部数据，提取完整字段集：
立即学习“PHP免费学习笔记（深入）”；
$allKeys = [];
foreach ($data as $row) {
$allKeys = array_unique(array_merge($allKeys, array_keys($row)));
}
sort($allKeys); // 可选，让字段字母序排列
- 之后仍用上一节的
array_map方式填充每行，缺失字段填空字符串或null - 注意：字段数变多会拉宽 CSV，Excel 打开时可能需手动调整列宽
- 若数据量极大（>10 万行），避免在内存中拼大数组，改用边读边写 +
yield流式处理
最易被忽略的是字段顺序一致性——哪怕只有一行顺序错了，整列数据就全偏移。别依赖 array_keys 的返回顺序，永远显式控制字段序列。
