在PHP开发场景中，我们经常会遇到需要先向页面输出实时提示信息，再触发文件下载的需求，比如用户点击导出按钮后，先显示导出进度，最后弹出文件下载框。很多人会疑惑PHP的实时输出和文件下载功能能不能混用，答案是可以，但需要严格遵循相关的实现规则，否则很容易出现功能异常。
混用的核心原理
PHP的实时输出依赖输出缓冲机制，而文件下载依赖正确的HTTP响应头和内容输出。二者混用的核心是先处理实时输出的缓冲，再发送文件下载相关的头信息，最后输出文件内容，避免头信息和内容顺序错乱导致的问题。
关键函数说明
- ob_start()：开启输出缓冲，后续的输出内容会先存入缓冲区而不是直接发送到客户端
- ob_flush()：将当前输出缓冲区的内容发送到客户端，但不会关闭缓冲区
- flush()：将服务器端的缓冲内容发送到客户端浏览器
- ob_end_clean()：清空并关闭输出缓冲区
正确的混用实现步骤
要实现先实时输出提示，再触发文件下载，需要按照以下顺序操作：
- 开启输出缓冲，输出实时提示内容并执行刷新操作
- 清空现有缓冲区，避免之前的输出内容混入下载文件
- 发送文件下载相关的HTTP头信息
- 输出文件内容，完成下载
完整代码示例
以下是一个先输出导出准备提示，再下载文本文件的完整示例：
<?php
// 关闭默认的输出缓冲配置，避免干扰
ini_set('output_buffering', 'off');
ini_set('zlib.output_compression', false);
// 开启自定义输出缓冲
ob_start();
// 输出实时提示内容
echo '正在准备导出文件，请稍候...';
echo str_repeat(' ', 4096); // 部分浏览器需要足够内容才会触发渲染
// 刷新缓冲区到客户端
ob_flush();
flush();
// 等待1秒模拟准备过程
sleep(1);
// 清空并关闭之前的缓冲区，避免提示内容混入下载文件
ob_end_clean();
// 要下载的文件内容
$fileContent = "这是导出的测试文件内容n第二行内容n第三行内容";
$filename = "test_export.txt";
// 发送文件下载相关的HTTP头
header('Content-Type: application/octet-stream');
header('Content-Disposition: attachment; filename="' . $filename . '"');
header('Content-Length: ' . strlen($fileContent));
header('Cache-Control: no-cache, no-store, must-revalidate');
header('Pragma: no-cache');
header('Expires: 0');
// 输出文件内容
echo $fileContent;
// 再次刷新确保内容发送
ob_flush();
flush();
exit;
?>
常见注意事项
- 实时输出内容后，一定要清空缓冲区再发送下载头，否则之前的输出内容会被当成下载文件的一部分，导致文件损坏
- HTTP头信息必须在所有输出内容之前发送，所以发送下载头之前不能有任何未清空的缓冲输出
- 部分浏览器需要输出足够长度的字符才会触发实时渲染，可以通过输出空格或者换行来凑足长度
- 如果使用了session，需要先关闭session再输出内容，避免session锁导致输出阻塞
错误示例说明
以下是一个常见的错误写法，会导致下载文件损坏：
<?php
// 错误示例：没有清空缓冲区就发送下载头
echo '准备导出...';
// 直接发送下载头，此时echo的内容还在缓冲区，头信息无法正确发送
header('Content-Type: application/octet-stream');
header('Content-Disposition: attachment; filename="error.txt"');
echo '文件内容';
?>
这个错误示例中，echo '准备导出...'的内容没有被清空，会导致header函数调用失败，或者输出内容混入下载文件，最终下载的文件会包含多余的提示内容，无法正常使用。
注意：如果实时输出需要显示HTML格式的内容，需要在发送下载头之前完成所有HTML输出，并且确保缓冲区完全清空后再设置下载相关的头信息，避免HTML标签内容混入下载文件。