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$ 块中添加：
立即学习“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() 就只是个安静的函数调用。
