PHP实时读取大文件输出方法详解

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。

遇到 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 这五道门，且每道门都默认关着。漏关任意一道，实时性就归零。