php实时输出配合sse怎么做_php实时输出sse推送教程【教程】_网络技术

PHP输出缓冲必须关闭，否则SSE无法实时推送；需设置正确响应头、严格遵循消息格式、处理连接断开与重连，并防止Web服务器及PHP-FPM中间层缓存。

SSE（Server-Sent Events）依赖服务端持续写入响应流，而 PHP 默认开启输出缓冲（output_buffering），会导致数据攒在缓冲区里不发出去。不关它，前端永远收不到第一条消息。

实操建议：

脚本开头加 ob_end_flush() 和 ob_flush()，再调用 flush()；更稳妥的做法是直接禁用：ini_set('output_buffering', 'Off')、ini_set('zlib.output_compression', 'Off')
Apache 下还要确认 mod_deflate 没对 SSE 响应做压缩（它会拦截并缓存响应），Nginx 则需关掉 gzip 或用 gzip off; 针对 SSE 路由
如果用了 PHP-FPM，buffer_size 设为 0（或 0s）避免 FPM 层缓存

SSE 要求响应头严格符合规范，漏掉或写错一个，浏览器就当普通 HTTP 响应处理，不会建立 EventSource 连接。

必须设置的 header：

header('Content-Type: text/event-stream') —— 类型错成 application/json 或漏掉，连接直接失败
header('Cache-Control: no-cache') —— 浏览器可能缓存初始响应，后续推送全失效
header('Connection: keep-alive') —— 显式声明长连接，避免代理/CDN 中断
可选但推荐：header('X-Accel-Buffering: no')（Nginx）防止其内部缓冲

SSE 协议规定消息格式极其简单，但容错极低：字段名必须小写，冒号后要空格，每条消息末尾必须是两个 \n（即 \n\n）。少一个换行，浏览器就卡住不解析。

正确示例：

data: {"status":"ok","time":1716234567}

data: hello

常见错误：

用 echo "event: ping\ndata: alive\n\n" 却忘了 echo 默认不带换行，得手动补 \n
JSON 字符串里混入 HTML 实体或未转义双引号，导致前端 JSON.parse() 报错
循环中没控制频率，高频 echo + flush() 可能触发 Apache 的 TimeOut 或 Nginx 的 proxy_read_timeout

PHP 无法主动感知客户端断开（除非用心跳+超时检测

），而浏览器 EventSource 在网络抖动或服务重启后会自动重连——但它只按固定规则重试（首次延迟 ~5s，之后指数退避），且不会传 cookie 或自定义 header。

实际要注意的点：

后端别假设连接永久存在，每次 echo 前先检查 connection_status() === CONNECTION_NORMAL，否则可能向已断连接写数据，触发警告甚至进程终止
需要鉴权？别依赖 session cookie（重连时不发），改用 URL 参数传 token，或前端初始化时先 fetch 一次获取临时凭证
若需保证消息不丢，服务端得维护游标（如 last_id），客户端重连时带上上次收到的 ID，服务端从该位置继续推

SSE 看似简单，真正跑稳的关键不在“怎么发”，而在“怎么不让它被中间层吞掉”和“怎么扛住连接反复断”。很多问题不是代码写错了，而是 Apache/Nginx/PHP-FPM 的默认缓冲策略在背后悄悄改写了你的响应流。