17370845950

PHP flush()不生效的主因是Web服务器（如Nginx/Apache）缓冲、浏览器渲染阈值（需≥1KB）及前端请求方式限制（AJAX不支持流式响应），须同步关闭PHP输出缓冲、服务端缓冲并采用SSE/WebSocket等正确接收方式。

PHP flush() 不生效的常见原因

PHP 的 flush() 和 ob_flush() 要想让数据立刻到达浏览器，得同时满足多个条件，缺一不可。最常被忽略的是 Web 服务器层的缓冲（如 Nginx、Apache）和浏览器自身的流式渲染策略。

• PHP 输出缓冲必须手动关闭或主动清空：默认开启 output_buffering，需在脚本开头调用 ob_end_flush() 或设为 0（通过 ini_set('output_buffering', 'Off') 不可靠，建议用 ob_end_clean() + ob_implicit_flush(true)）
• Web 服务器可能拦截小块响应：Nginx 默认启用 fastcgi_buffering on，需显式关掉；Apache 的 mod_deflate 也会缓存压缩前内容，要禁用或设置 SetEnv no-gzip 1
• 浏览器需要收到足够多字节才开始解析：Chrome/Firefox 通常等待至少 1KB 数据或遇到 开头才渲染，可在输出前加 1024 字节空格（str_repeat(' ', 1024)）绕过

完整可运行的实时输出示例（含兼容性处理）

以下代码在 CLI、Apache、Nginx（配置正确时）下均能逐行输出，关键在于顺序和兜底措施：

// 发送初始空白填充（绕过浏览器最小渲染阈值）
echo str_repeat(' ', 1024);
flush();
// 实时输出循环
for ($i = 0; $i < 5; $i++) {
echo "第 {$i} 次输出\n";
flush(); // 必须紧跟 echo 后
sleep(1);
}
?>

注意：sleep() 在生产环境慎用；若用 usleep(100000) 替代，需确保未触发 PHP 的最大执行时间限制。

Nginx 下必须修改的 fastcgi 配置项

仅 PHP 层调用 flush() 不够，Nginx 默认会把整个响应体攒够再发。需在 location ~ \.php$ 块中添加：

fastcgi_buffering off;
fastcgi_request_buffering off;
# 可选：禁用 gzip（若启用则需确保不缓存）
gzip off;

改完后必须 nginx -t && nginx -s reload，否则配置不生效。Apache 用户则需确认 mod_headers 已启用，并添加 Header set X-Accel-Buffering "no"。

为什么 AJAX 请求收不到实时 chunk？

浏览器的 XMLHttpRequest（包括 fetch）默认等待响应结束才触发 onload，无法监听流式响应。真正可行的方式只有：

• 使用 EventSource（SSE）：服务端输出 Content-

  

  Type: text/event-stream，客户端监听 message 事件
• 用 XMLHttpRequest 的 responseText + onprogress（但兼容性差，且部分浏览器只在收到完整响应头后才触发）
• WebSocket：适合双向实时通信，但需额外服务支持（如 Ratchet、Swoole）

单纯靠 fetch().then() 是拿不到中间 flush 数据的——它根本不会分段回调。

真正卡住的地方往往不在 PHP 代码本身，而是 Nginx/Apache 的隐式缓冲、浏览器的渲染策略，以及前端请求方式的误选。漏掉任意一环，flush() 就只是个安静的函数调用。