PHP触发浏览器下载CSV文件功能失效问题排查

问题根因 #

你的下载逻辑无法运行有两个核心问题：

1. 写入php://memory内存流的CSV内容从未被输出到HTTP响应体：你在rewind($f)重置流指针后直接执行了fclose($f)关闭流，浏览器只收到了文件下载的响应头，拿不到实际文件内容，自然无法完成下载。
2. 响应头配置错误：Content-Encoding头用于声明响应的传输编码（如gzip、br），不能设置为UTF-8，错误配置会导致浏览器解析响应异常。

修复后完整代码 #

<?php
$arreglo[0] = array("Nombre","Apellido","Animal","Fruto");
$arreglo[1] = array("Juan","Juarez","Jirafa","Jicama");
$arreglo[2] = array("Maria","Martinez","Mono","Mandarina");
$arreglo[3] = array("Esperanza","Escobedo","Elefante","Elote");
$filename = "prueba.csv";
$delimitador = ",";
$encapsulador = '"';

// 配置下载响应头
header('Content-Type: text/csv; charset=UTF-8');
header('Content-Disposition: attachment; filename="' . $filename . '";');
// 禁用缓存，兼容旧版浏览器
header('Cache-Control: no-cache, no-store, must-revalidate');
header('Pragma: no-cache');
header('Expires: 0');

$f = fopen('php://memory', 'w');
// 写入UTF-8 BOM，解决Windows下Excel打开乱码问题
fwrite($f, "\xEF\xBB\xBF");
foreach ($arreglo as $linea) {
    fputcsv($f, $linea, $delimitador, $encapsulador);
}
rewind($f);
// 将内存流中的CSV内容输出到响应
fpassthru($f);
fclose($f);
// 终止后续执行，避免多余输出破坏文件结构
exit;
?>

关键修改说明 #

• 删除了错误的Content-Encoding: UTF-8头，字符集声明统一放在Content-Type头中
• 新增fpassthru($f)方法，在流指针重置后把内存中存储的全部CSV内容输出到响应，这是原代码缺失的最核心逻辑
• 增加缓存控制头，避免部分浏览器因缓存策略导致下载失败
• 可选写入UTF-8 BOM头，解决Windows平台Excel打开CSV的乱码问题
• 内容输出完成后加exit终止脚本执行，防止其他业务逻辑输出多余字符导致CSV文件损坏

内容的提问来源于stack exchange，提问作者María Del Pilar Fernández