PHP长连接实时输出优化技巧

PHP实现长连接实时输出（如SSE或流式响应）的关键难点不在代码本身，而在于穿透层层中间件的缓冲与超时机制——Nginx、PHP-FPM、Apache、浏览器甚至代理服务器都可能悄无声息地截断、缓存或终止连接；真正稳定运行需同步调优三端：Nginx中关闭proxy_buffering和fastcgi_buffering、扩大缓冲区配置；PHP层禁用超时、清空输出缓冲、关闭压缩并手动flush；服务端还需配合高频心跳（如每15–30秒发送SSE注释）对齐Nginx的keepalive_timeout与send_timeout，否则再完美的代码也会在生产环境中“神秘断连”。

PHP 实时输出长连接（比如 Server-Sent Events 或流式响应）本身不难，难的是在真实环境中稳定维持——多数失败不是因为代码写错，而是被中间层（Nginx、Apache、PHP-FPM、浏览器或代理）悄悄截断、缓冲或超时。

为什么 flush() 和 ob_flush() 经常没反应

这两个函数只是把 PHP 输出缓冲区的内容“推给 SAPI”，但之后还卡在 Web 服务器和网络栈手里。常见失效原因：

• Nginx 默认开启 proxy_buffering on，会攒够 4KB 或等响应结束才发给客户端
• PHP-FPM 的 buffer_output = yes（默认）会让输出先进 FPM 缓冲区
• Apache 的 mod_deflate 或 mod_php 输出过滤器可能延迟发送
• 浏览器（尤其 Safari）对未带 Content-Type: text/event-stream 的流式响应会等 1~3 秒再渲染

实操建议：用 curl -N http://your.app/stream.php 测试（-N 关闭 curl 自动缓冲），比浏览器更可信。

Nginx 下必须关掉的三项配置

只要走 Nginx + PHP-FPM，这三处不改，flush() 基本等于摆设：

• proxy_buffering off;（在 location 块里）
• proxy_buffer_size 4k; 改成 proxy_buffer_size 128k; 并配 proxy_buffers 8 128k;（避免小包被合并）
• fastcgi_buffering off;（Nginx 1.11.5+ 才支持；旧版本得用 fastcgi_buffer_size 128k; fastcgi_buffers 8 128k; 并确保 fastcgi_busy_buffers_size 足够大）

漏掉任何一项，都可能看到前几条数据正常，后面突然卡住或直接断连。

PHP 层该设的最小安全配置

光关缓冲不够，还要防超时和自动清理：

• 开头加 set_time_limit(0); —— 否则脚本 30 秒后被 PHP 强杀
• 禁用输出压缩：if (function_exists('apache_setenv')) { apache_setenv('no-gzip', '1'); }（Apache）或 ini_set('zlib.output_compression', 'Off');
• 清空所有已启用的输出缓冲：while (ob_get_level()) ob_end_clean();，再 ob_implicit_flush(true);
• 每条消息后加换行和双换行（SSE 要求）：echo "data: hello\n\n"; flush();

注意：ob_implicit_flush(true) 不等于自动 flush()，它只让每个 echo 后隐式调用一次，仍需手动 flush() 确保穿透到 SAPI。

超时控制必须前后端对齐

长连接不是“永不超时”，而是要明确谁管哪段超时：

• PHP：set_time_limit(0) 只防脚本执行超时，不防连接空闲超时
• Nginx：proxy_read_timeout 300; 控制 upstream 返回间隔，别设太短（如 60 秒）
• 浏览器：SSE 自动重连，但首次连接若卡住，会等 EventSource 的 timeout（非标准属性，实际靠服务端心跳）
• 推荐方案：服务端每 15~30 秒发一条空注释 ": heartbeat\n\n，既保活又不触发前端 message 事件

最容易被忽略的是 Nginx 的 keepalive_timeout 和 send_timeout —— 如果它们比你的业务心跳还短，连接会在你毫无察觉时被 Nginx 主动断开。

理论要掌握，实操不能落！以上关于《PHP长连接实时输出优化技巧》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！