PHP实时输出需PHP缓冲控制、Web服务器配置和浏览器渲染策略三者协同;默认因output_buffering启用而无法实时,须同时关闭PHP层缓冲、禁用服务器代理缓冲并触发浏览器渲染。

PHP 实时输出不是靠 echo 或 print 本身生效的,而是依赖输出缓冲控制 + Web 服务器行为 + 浏览器渲染策略三者配合;不主动干预,默认根本不会“实时”。
为什么 echo 后浏览器没立刻看到?
PHP 默认启用输出缓冲(output_buffering),所有 echo 内容先存进内存缓冲区,等脚本结束或缓冲区满才一次性发给 Web 服务器。Nginx/Apache 还可能再加一层缓冲,浏览器也可能等待完整响应或足够字节数才开始渲染。
常见现象:sleep(1) 前后各 echo "a"; 和 echo "b";,结果是两秒后一起显示 “ab”,而非隔一秒显示一个字母。
- 检查当前缓冲状态:运行
var_dump(ob_get_level());—— 非 0 表示有活跃缓冲 -
php.ini中output_buffering = 4096是默认值,即攒够 4KB 才刷出 - CLI 模式下通常无缓冲,但 Web SAPI(如 FPM)默认全开
如何强制逐段输出?关键三步缺一不可
必须同时关闭 PHP 层缓冲、禁用 Web 服务器代理缓冲、并触发浏览器立即渲染。漏掉任意一步都会失败。
立即学习“PHP免费学习笔记(深入)”;
- 调用
ob_end_flush()或ob_flush()+flush():前者清空并关闭当前缓冲层,后者仅刷出当前层(需配合ob_start()手动开启) - 在脚本开头加
ini_set('output_buffering', 'Off');和ini_set('zlib.output_compression', 'Off');—— 否则 gzip 压缩会拦截原始字节流 - 对 Nginx,需在 location 块中加
proxy_buffering off;;Apache + mod_php 一般无需额外配置,但用 FPM 时要确认fastcgi_buffering off; - 为防浏览器“攒着不画”,每段输出末尾追加足够空白(如
str_repeat(" ", 512))或换行符,部分旧版 Chrome/Safari 依赖这个触发渲染
flush() 不生效的典型场景与绕过方式
flush() 只对当前 PHP 输出缓冲层起作用,它不能穿透 Web 服务器或 CDN 的缓冲。如果用了 Cloudflare、Nginx proxy_buffer、或某些负载均衡器,flush() 发出去的数据仍被卡住。
- 测试是否真发出:用
curl -N http://yoursite.com/script.php(-N禁用 curl 缓冲),观察是否分段收到 - 生产环境更可靠的做法是改用 Server-Sent Events(SSE):用
header('Content-Type: text/event-stream');+echo "data: ...\n\n";+ob_flush(); flush();,浏览器EventSource自动处理流式接收 - 避免在输出中途调用
session_start()—— 它会隐式开启缓冲且无法关闭,导致后续flush()失效
一个能跑通的最小 SSE 示例
比纯 flush() 更稳定,兼容性好,且天然支持断线重连。
header('Content-Type: text/event-stream');
header('Cache-Control: no-cache');
header('Connection: keep-alive');
// 防止 session 锁住输出
if (session_status() === PHP_SESSION_ACTIVE) {
session_write_close();
}
for ($i = 0; $i < 5; $i++) {
echo "data: {" . json_encode(['step' => $i, 'time' => time()]) . "}\n\n";
ob_flush();
flush();
sleep(1);
}
注意:SSE 要求响应头带 text/event-stream,且每条消息以 data: ... \n\n 结尾;客户端用 new EventSource('/stream.php') 监听即可。别指望用 file_get_contents 测试——它不支持流式读取。
真正难的不是写几行 echo 和 flush(),而是厘清哪一层在缓冲、谁在拦截、以及浏览器到底等什么信号才肯画。线上环境里,Nginx 配置和 CDN 设置往往比 PHP 代码更关键。











