PHP流式输出需禁用五层缓冲:PHP输出缓冲、zlib压缩、Web服务器缓冲(Nginx设fastcgi_buffering off)、浏览器首屏延迟(前置1024空格)、连接中断检测(connection_aborted)。

为什么 fread() 读大文件不实时?
直接用 fread($fp, 8192) 配合 echo,浏览器往往等整个文件读完才显示——不是 PHP 没输出,而是输出被缓冲了。PHP 默认启用 output_buffering,且 Web 服务器(如 Nginx)和浏览器自身也有缓冲策略。关键不是“怎么读”,而是“怎么让每段输出立刻穿透所有缓冲层”。
-
ob_flush()清除 PHP 输出缓冲区 -
flush()尝试把内容推给 Web 服务器(但对 FastCGI 无效) - Nginx 默认关闭
fastcgi_buffering off,否则它会攒够 4KB 或等响应结束才发包 - 浏览器可能等待首个 1KB 数据才开始渲染,所以开头建议先输出
str_repeat(' ', 1024)
PHP 流式输出必须关掉哪些缓冲?
缺一不可,否则任一环节卡住,前端就收不到分块数据:
- 禁用 PHP 输出缓冲:
if (ob_get_level()) ob_end_flush();+ini_set('output_buffering', 'Off'); - 关闭 zlib 压缩:
ini_set('zlib.output_compression', 'Off');(压缩会强制缓冲) - 确保
implicit_flush开启:ini_set('implicit_flush', 1);(让每个echo自动触发 flush) - Apache 用户需确认
mod_deflate已禁用或配置为不压缩 text/plain;Nginx 必须在 location 块加fastcgi_buffering off;
用 fopen() + fread() 实时吐数据的最小可靠写法
不要依赖 readfile() 或 fpassthru() ——它们是全量输出,无法控制节奏。以下代码能稳定逐块输出并被浏览器接收:
header('Content-Type: text/plain; charset=utf-8');
header('X-Accel-Buffering: no'); // Nginx 专用,强制不缓存
// 先填满首屏避免浏览器延迟渲染
echo str_repeat(" ", 1024);
ob_flush();
flush();
$fp = fopen('/bigfile.log', 'rb');
if (!$fp) die('Cannot open file');
while (!feof($fp)) {
$chunk = fread($fp, 8192);
if ($chunk === false) break;
echo $chunk;
// 每次输出后主动冲刷(implicit_flush=1 时可省略,但显式写更可控)
if (connection_aborted()) break;
}
fclose($fp);
注意:connection_aborted() 要检查,否则用户关页面,PHP 还在后台读完几 GB。
立即学习“PHP免费学习笔记(深入)”;
遇到 ERR_INCOMPLETE_CHUNKED_ENCODING 怎么办?
这是浏览器收到不完整 chunk 编码响应的典型报错,常见于:Nginx 没关 fastcgi_buffering、PHP 脚本超时被 kill、或输出中途发生 fatal error 导致响应截断。
- 查 Nginx error log,确认是否出现
upstream prematurely closed - 加大脚本限制:
set_time_limit(0); ini_set('max_execution_time', '0'); - 避免在循环中触发错误(比如未检查
fread()返回值为false就继续echo) - 不要用
exit中断流程,改用die并确保已 flush,否则响应头可能都未发全
真正麻烦的从来不是读文件,而是让每一字节都穿过 PHP → SAPI → Web Server → TCP → Browser 这五道门,且每道门都默认关着。漏关任意一道,实时性就归零。











