解决PHP导出空CSV文件：深入理解HTTP头与文件流

<?php
// 1. 定义文件名和数据
$fileName = 'CSV-Export.csv';
$lists = [
    [
        'product_id' => 101,
        'product_name' => "Apple iPhone 15",
        'price' => 7999.00
    ],
    [
        'product_id' => 102,
        'product_name' => "Samsung Galaxy S24",
        'price' => 6999.50
    ],
    [
        'product_id' => 103,
        'product_name' => "Google Pixel 8",
        'price' => 5999.99
    ]
];
$columnNames = [
    'Product ID',
    'Product Name',
    'Price'
];

// 2. 设置HTTP头部，确保在任何输出之前发送
header('Content-Description: File Transfer');
header('Content-Type: application/csv');
header("Content-Disposition: attachment; filename=\"".$fileName."\""); // 注意文件名需要用双引号包裹
header('Cache-Control: must-revalidate');
header("Content-Transfer-Encoding: UTF-8");
// 针对Excel等软件可能需要BOM头，如果出现乱码可以考虑添加
// echo "\xEF\xBB\xBF"; // UTF-8 BOM

// 3. 直接输出CSV内容
// 报告标题（可选）
echo "产品销售报告\r\n";
echo "\r\n"; // 空行

// 输出列名
echo implode(",", $columnNames) . "\r\n";

// 输出数据行
foreach ($lists as $value) {
    // 确保数据中的逗号、双引号等特殊字符被正确处理，这里使用简单的implode，
    // 实际生产环境建议使用fputcsv的内存版本或手动转义
    $rowData = [
        $value['product_id'],
        $value['product_name'],
        $value['price']
    ];
    // 简单地用逗号连接，未处理特殊字符转义，生产环境需更健壮的CSV格式化
    echo implode(",", $rowData) . "\r\n";
}

// 4. 终止脚本执行
exit(0);
?>

<?php
// 1. 定义文件名和数据
$fileName = 'CSV-Export.csv';
$lists = [
    [
        'product_id' => 201,
        'product_name' => "Laptop Pro",
        'price' => 12000.00
    ],
    [
        'product_id' => 202,
        'product_name' => "Wireless Mouse",
        'price' => 150.00
    ]
];
$columnNames = [
    'Product ID',
    'Product Name',
    'Price'
];

// 确保CSV文件存储目录存在且可写
$csvDir = 'csv/';
if (!is_dir($csvDir)) {
    mkdir($csvDir, 0777, true);
}
$filePath = $csvDir . $fileName;

// 2. 将CSV内容写入本地文件
// 使用 'w' 模式打开文件，如果文件不存在则创建，如果存在则清空
$file = fopen($filePath, "w");
if ($file === false) {
    die("无法创建或打开CSV文件: " . $filePath);
}

// 写入报告标题和空行
fwrite($file, "产品销售报告 (本地生成)\r\n");
fwrite($file, " \r\n");

// 写入列名
// fputcsv 会自动处理CSV格式化（逗号、双引号转义）
fputcsv($file, $columnNames);

// 写入数据行
foreach ($lists as $value) {
    fputcsv($file, [
        $value['product_id'],
        $value['product_name'],
        $value['price']
    ]);
}
fclose($file); // 写入完成后立即关闭文件

// 3. 设置HTTP头部，准备流式传输
// 确保在任何输出之前发送
header('Content-Description: File Transfer');
header('Content-Type: application/csv');
header("Content-Disposition: attachment; filename=\"".$fileName."\"");
header('Cache-Control: must-revalidate');
header("Content-Transfer-Encoding: UTF-8");
// 也可以添加 Content-Length 头部，提高下载体验
// header('Content-Length: ' . filesize($filePath));

// 4. 从本地文件读取内容并输出到浏览器
$stream = fopen($filePath, "r");
if ($stream === false) {
    die("无法打开已创建的CSV文件进行读取: " . $filePath);
}

// 逐块读取并输出文件内容，避免一次性加载大文件到内存
while (!feof($stream)) {
    echo fread($stream, 8192); // 每次读取8KB
    flush(); // 立即将输出发送到浏览器
}
fclose($stream); // 关闭文件流

// 5. 终止脚本执行
// 可选：下载完成后删除服务器上的临时文件
// unlink($filePath);
exit(0);
?>