实时输出失效主因是三层缓冲:PHP层需禁用output_buffering并清空缓冲栈;Web服务器层Nginx需proxy_buffering off、chunked_transfer_encoding on,Apache需禁用mod_deflate;浏览器端小响应可能被Safari等延迟渲染。

PHP 实时输出(如 ob_flush() + flush())本身开销极小,真正的性能瓶颈几乎从不在这两个函数上,而在于输出前的阻塞点:Web 服务器缓冲、PHP 输出缓冲栈配置、客户端网络或渲染行为。
为什么 flush() 看似没生效?查这三处缓冲层
实时输出失效,90% 是因为数据卡在某一层缓冲里,没真发到浏览器:
- PHP 输出缓冲:检查是否启用了
output_buffering(php.ini中默认常为4096或On),必须设为Off或0;用ob_get_level()确认当前无活跃输出缓冲器 - Web 服务器层:Nginx 默认禁用响应流式传输,需在 location 块中加
proxy_buffering off;和chunked_transfer_encoding on;;Apache 则需确保未启用mod_deflate(压缩会强制缓存整个响应)或用SetEnv no-gzip 1临时禁用 - 浏览器端:某些浏览器(尤其是移动端 Safari)对小块响应(str_repeat(' ', 1024))“垫底”触发流式解析
ob_flush() 和 flush() 的调用顺序不能颠倒
这两个函数作用对象不同,顺序错就白调:
-
ob_flush()清空 PHP 用户级输出缓冲区(即ob_start()开启的那一层) -
flush()将 Web 服务器的底层响应缓冲区内容推给客户端 - 必须先
ob_flush(),再flush();若中间夹了echo或print,可能又进新缓冲,得重复调用 - 常见错误写法:
flush(); ob_flush();—— 这会漏掉用户缓冲区里的内容
CLI 模式下 flush() 无效?那是预期行为
PHP CLI 不走 HTTP 协议栈,flush() 对 stdout 无实际效果(终端本身不支持 HTTP chunked 编码)。此时实时输出应依赖:
立即学习“PHP免费学习笔记(深入)”;
- 禁用 CLI 的隐式输出缓冲:
ini_set('output_buffering', '0'); - 用
fwrite(STDOUT, $data); fflush(STDOUT);替代echo+flush() - 避免使用
var_dump()或print_r()(它们会格式化并可能触发内部缓冲),改用echo+ 手动换行
真正卡顿的地方,往往藏在你调用 flush() 前的那几行业务逻辑里——比如一次慢查询、一个同步 HTTP 请求、或未声明 Content-Type: text/event-stream 导致浏览器静默攒包。别只盯着 flush,先用 microtime(true) 定位耗时段。











