PHP已发送响应头后如何实现文件下载？

针对你遇到的响应头已发送、重构缓冲逻辑太复杂的情况，有几个可行的解决办法：

1. 提前开启输出缓冲并清空已输出内容 #

在所有协同脚本的入口位置（比如最顶层的启动文件）提前开启输出缓冲，等到要导出CSV时，清空之前的所有输出，就能正常设置响应头了。

代码示例：

// 在脚本最开头添加，确保所有输出都进入缓冲
ob_start();

// ... 原有脚本逻辑，生成$result数据集和$headers表头 ...

// 开始处理CSV导出
$fp = fopen('php://output', 'w');
if ($fp && $result) {
    // 清空缓冲中的所有内容，避免之前的输出导致头已发送错误
    ob_end_clean();
    
    header('Content-Type: text/csv');
    header('Content-Disposition: attachment; filename="export.csv"');
    header('Pragma: no-cache');
    header('Expires: 0');
    
    fputcsv($fp, $headers);
    while ($row = $result->fetch_array(MYSQLI_NUM)) {
        fputcsv($fp, array_values($row));
    }
    fclose($fp);
    exit;
}

2. 用独立脚本+iframe触发下载 #

如果不想修改现有脚本的缓冲逻辑，可以把CSV导出逻辑单独放到一个新的PHP文件里，然后在主页面通过隐藏iframe触发下载请求。这样独立脚本不受主页面的输出影响，能正常设置响应头。

主页面添加触发代码：

<button onclick="document.getElementById('csv-download-iframe').src='export-csv.php'">导出CSV</button>
<iframe id="csv-download-iframe" style="display: none;"></iframe>

export-csv.php中放入你的导出逻辑（无需担心头已发送问题）：

// 这里直接写原有的导出代码，比如先获取$result和$headers
$fp = fopen('php://output', 'w');
if ($fp && $result) {
    header('Content-Type: text/csv');
    header('Content-Disposition: attachment; filename="export.csv"');
    header('Pragma: no-cache');
    header('Expires: 0');
    fputcsv($fp, $headers);
    while ($row = $result->fetch_array(MYSQLI_NUM)) {
        fputcsv($fp, array_values($row));
    }
    fclose($fp);
    exit;
}

3. 清空所有嵌套的输出缓冲层 #

如果没法提前在脚本开头开启缓冲，可以在准备导出CSV前，循环清空所有已存在的输出缓冲层，确保没有内容被发送到浏览器。

代码示例：

// 清空所有输出缓冲
while (ob_get_level() > 0) {
    ob_end_clean();
}

// 执行原有的CSV导出逻辑
$fp = fopen('php://output', 'w');
if ($fp && $result) {
    header('Content-Type: text/csv');
    header('Content-Disposition: attachment; filename="export.csv"');
    header('Pragma: no-cache');
    header('Expires: 0');
    fputcsv($fp, $headers);
    while ($row = $result->fetch_array(MYSQLI_NUM)) {
        fputcsv($fp, array_values($row));
    }
    fclose($fp);
    exit;
}

内容的提问来源于stack exchange，提问作者Adrien Hingert