如何使用ThinkPHP实现SSE服务器发送事件_长连接流式响应及前端接收

秋强大大_1096

秋强大大_1096

2026-05-03

592人浏览

原创

ThinkPHP 返回SSE需手动控制输出:先ob_end_clean()清缓冲,再header设text/event-stream和no-cache,循环echo"data:...\n\n"并flush()、ob_flush()。

如何使用thinkphp实现sse服务器发送事件_长连接流式响应及前端接收

ThinkPHP 怎么返回 SSE 响应头和流式内容

ThinkPHP 默认响应会缓冲输出、自动添加 Content-Length,这直接破坏 SSE 的「流式」本质。必须手动控制输出缓冲、禁用自动响应头,并保持连接不关闭。

关键操作有三步:

  • 调用 ob_end_clean() 清掉已启动的输出缓冲(否则首段数据发不出)
  • 用 header() 显式设置 Content-Type: text/event-stream 和 Cache-Control: no-cache
  • 每次发送数据前,用 echo "data: ...\n\n" 格式,并紧跟 flush() 和 ob_flush()

示例片段(放在控制器方法中):

header('Content-Type: text/event-stream');
header('Cache-Control: no-cache');
header('X-Accel-Buffering: no'); // Nginx 下防代理缓存

ob_end_clean(); // 必须!否则卡在缓冲层

while (true) {
    echo "data: " . json_encode(['time' => date('H:i:s')]) . "\n\n";
    flush();
    ob_flush();
    sleep(1);
}

为什么 ThinkPHP 的 Response 类不能直接用于 SSE

因为 Response 类默认走完整生命周期:收集全部输出 → 计算 Content-Length → 一次性 send。而 SSE 要求「边生成边发」,且不能有 Content-Length 头(否则浏览器等完整响应才解析)。

常见错误现象:

  • 前端收到第一个 data: 后就断连 → 是因为 ThinkPHP 自动加了 Connection: close 或响应体被截断
  • Chrome 控制台显示 net::ERR_INCOMPLETE_CHUNKED_ENCODING → 输出缓冲没清干净,或 flush() 失效
  • Nginx 返回 504 → 没设 proxy_buffering off 或超时太短

前端用 EventSource 接收时要注意什么

EventSource 看似简单,但 ThinkPHP 后端若没按 SSE 协议严格输出,它会静默重连或直接失败,很难定位。

HISUI 前端框架开发指南(IRIS版)
HISUI 前端框架开发指南(IRIS版)

HISUI 前端框架基础开发指南。HISUI 是基于 easyui 二次开发的 jQuery UI 组件库,专为医疗信息系统设计。当涉及 HISUI 组件开发、jQuery easyui 表格/表单/布局/窗口、医疗系统前端页面编写时使用此 skill。 涵盖 40 个组件的官方文档参考,支持声明式与编程式两种初始化方式,提供 $cm/$m 数据访问方法。

下载

实操建议:

  • 确保后端每条消息以 data: ... \n\n 结尾(两个换行),不能只一个 \n
  • 不要在后端混用 echo 输出非 data: 内容(比如调试 var_dump),EventSource 会当作非法帧丢弃整段
  • 前端监听 error 事件时,注意它可能频繁触发(网络抖动、服务端短暂中断),别直接 console.error 就完事,要判断 event.target.readyState
  • 如果需要自定义字段(如 id:、event:),后端必须严格换行分隔,例如:id: 123\nevent: update\ndata: ...\n\n

Nginx 配置 SSE 时最容易漏掉的三项

本地开发用 PHP 内置服务器可能跑通,一上 Nginx 就断连或延迟严重——问题几乎全出在反向代理配置上。

必须显式配置:

  • proxy_buffering off; —— 关闭 Nginx 缓冲,否则它攒够 4KB 才转发
  • proxy_cache off; 和 proxy_set_header Cache-Control 'no-cache' —— 防 CDN 或代理层缓存响应流
  • proxy_read_timeout 300; —— 默认 60 秒,SSE 长连接需延长,否则 Nginx 主动断开

另外,如果用了 fastcgi(PHP-FPM),还要加 fastcgi_buffering off;,否则 FPM 层也会缓冲。

SSE 在 ThinkPHP 里不是“配个路由就能用”的功能,核心在于绕过框架默认响应机制,手动接管输出流。每个环节——PHP 缓冲、Web 服务器代理、前端解析规则——只要有一处不守协议,整个流就卡住或断开。最常被忽略的是 ob_end_clean() 的位置和 Nginx 的 proxy_buffering 开关。

php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

php thinkphp 前端

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2943

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

6423

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

7310

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

7178

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

1023

5

php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2023.09.01

12584

6

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

7241

5

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

2235

5

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

2023.10.23

4568

4

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习