PHP实现导出与指定表头匹配的CSV文件求助

问题场景 #

需要导出与指定表头顺序一致的CSV文件，部分数据项缺失表头对应的字段，缺失字段需留空。现有表头数组和数据数组如下：

表头数据 #

$headers = array('name', 'sku', 'short_description', 'brand', 'website', 'price', 'url_key', 'weight', 'length');

数组数据 #

$data = array(
    array('name'=>'Name 1', 'brand'=>'Brand 1', 'url_key'=>'URL key 1', 'length'=>'length 1'),
    array('name'=>'Name 2', 'short_description'=>'Shord Description 2', 'sku'=>'SKU 2', 'price'=>'Price2'),
    array('name'=>'Name 3', 'sku'=>'SKU 3', 'website'=>'Website 3', 'price'=>'Price 3', 'url_key'=>'URL KEY 3', 'length'=>'Lenght 3'),
    array('sku'=>'SKU 4', 'short_description'=>'Short Des 4', 'website'=>'Website 4', 'price'=>'Price4', 'url_key'=>'URL KEY 4')
);

解决方案 #

使用PHP的fputcsv函数处理CSV生成，确保每条数据严格按表头顺序输出，缺失字段自动留空。以下是完整实现代码：

// 设置CSV下载响应头
header('Content-Type: text/csv; charset=utf-8');
header('Content-Disposition: attachment; filename=export.csv');

// 打开输出流
$output = fopen('php://output', 'w');

// 写入表头行
fputcsv($output, $headers);

// 遍历处理每条数据
foreach ($data as $row) {
    $csvRow = [];
    // 按表头顺序提取字段值，缺失则留空
    foreach ($headers as $header) {
        $csvRow[] = isset($row[$header]) ? $row[$header] : '';
    }
    // 写入当前行到CSV
    fputcsv($output, $csvRow);
}

// 关闭输出流
fclose($output);
exit;

代码说明 #

1. 响应头设置：告诉浏览器这是CSV文件并触发下载，指定文件名export.csv
2. 表头写入：直接将表头数组写入CSV第一行
3. 数据行处理：遍历每条数据时，严格按照表头顺序逐个提取字段值——如果数据中存在该字段则取值，否则用空字符串填充
4. fputcsv函数：自动处理CSV中的特殊字符（如逗号、引号），避免格式错误

运行代码后，导出的CSV文件会完全匹配表头顺序，缺失字段显示为空单元格，符合需求。

内容的提问来源于stack exchange，提问作者Sunny Rahevar