PHP实时输出需关闭缓冲：调用ob_implicit_flush(true)和ob_end_flush()，禁用zlib/Nginx gzip；推荐EventSource（Content-Type: text/event-stream，data: xxx\n\n格式），兼容性差时改用fetch+ReadableStream手动流式读取；注意Nginx proxy_buffering off、Apache X-Accel-Buffering: no及浏览器心跳维持。
PHP 后端启用实时输出的关键设置
默认情况下 PHP 会缓冲全部输出再一次性发给前端，想让前端“逐段接收”，得先关掉缓冲。关键不是 echo 多少次，而是控制底层输出流。
- 必须调用
ob_implicit_flush(true)开启隐式刷新（否则echo仍被缓冲） - 推荐配合
ob_end_flush()清空已有输出缓冲区（尤其在框架或 include 后容易残留） - 如果用了
zlib.output_compression或 Nginx 的gzip，必须关闭——压缩会阻塞流式传输 - CLI 模式下默认无缓冲，但 Web SAPI（如 Apache/FPM）必须显式干预
前端用 EventSource 监听最简单可靠
EventSource 是专为服务端推送设计的原生 API，自动重连、解析 data: 格式，比手动轮询或 WebSocket 更轻量，适合日志、进度、状态类实时输出。
- 后端需返回
Content-Type: text/event-stream，且响应头不能含Cache-Control: no-cache（某些旧版浏览器要求） - 每条消息以
data: xxx\n\n结尾（两个换行），前端onmessage自动截掉data:前缀 - 若 PHP 脚本执行时间长，记得设
set_time_limit(0)，并避免超时中断连接 - 注意：Safari 对
EventSource的 CORS 支持较弱，跨域时优先考虑同源或改用 fetch +response.body.getReader()
用 fetch + ReadableStream 手动读取原始流（兼容性更强）
当需要更细粒度控制（比如逐字符解析、自定义分隔符），或支持 Safari/IE 等不支持 EventSource 的环境，可走底层流式读取。
- 后端只需保持
Content-Type: text/plain（或任意类型），持续echo "chunk\n"并调用flush() - 前端用
fetch(url).then(r => r.body.getReader())获取ReadableStreamDefaultReader - 循环调用
reader.read()，每次拿到{ done, value }，value是Uint8Array，需用new TextDecoder().decode(value)转字符串 - 必须手动处理粘包（比如一次
read()可能含多行，或一行被拆成两次），建议用\n分割后再逐条处理
常见失败原因和绕过技巧
很多“实时输出失效”其实和 PHP 本身无关，而是中间层或浏览器策略卡住。
立即学习“PHP免费学习笔记（深入）”；
- Nginx 默认开启
proxy_buffering on，必须在 location 块中加proxy_buffering off;和proxy_cache off; - Apache 的
mod_deflate会拦截并缓存输出，需在响应前加header('X-Accel-Buffering: no'); - Chrome 对空响应体的 SSE 连接会 3 秒后静默断开，后端至少每 15 秒发一次
:keepalive\n\n（注释行）维持心跳 -
flush()在 FPM 下可能无效，确认php-fpm.conf中buffer_output = no，且未启用fastcgi_finish_request()
实际最难调的往往不是代码逻辑，而是 Nginx/Apache 的缓冲开关和浏览器对空帧的容忍度——这些地方一漏，前端就收不到第一个字节。
