ThinkPHP如何实现高性能的实时通讯_集成WebSocket与定时任务-ThinkPHP-PHP中文网

websocket断开主因是swoole心跳配置不匹配，需调大heartbeat_idle_time并配heartbeat_check_interval；客户端须主动发ping；fd跨进程无效，应存redis/swoole\table并带worker_id；onopen禁用同步io；nginx需透传upgrade头。

thinkphp如何实现高性能的实时通讯_集成websocket与定时任务

WebSocket 连接断开后不重连？检查 `swoole_websocket_server` 的心跳与超时配置

ThinkPHP 自身不内置 WebSocket 服务，所谓“集成”实际是依赖 Swoole 扩展启动独立长连接服务，TP 只负责消息路由和业务逻辑。很多项目卡在连接建立后几秒自动断开，根本原因是 swoole_websocket_server 默认的 heartbeat_idle_time（默认 60 秒）和客户端 ping/pong 不匹配。

客户端必须主动发 ping，服务端才能触发 onMessage 中的 pong 响应；若客户端静默，Swoole 会在 idle 超时后强制 close 连接
在 server.php 启动脚本中显式设置：'heartbeat_idle_time' => 300（5 分钟），同时配 'heartbeat_check_interval' => 10，避免误杀活跃连接
浏览器 WebSocket 实例不会自动发 ping，得自己用 setInterval(() => ws.send(''), 5000) 维持心跳——别依赖 onopen 后就万事大吉

定时任务推送消息到指定 WebSocket 连接？别直接用 `think\facade\Cache` 存 fd

Swoole 的 fd（文件描述符）只在当前 Worker 进程内有效，跨进程或重启后失效。用 TP 的缓存驱动（如 file、redis）存 fd 看似可行，但极易导致“推送无声”：定时任务跑在另一个进程里，server->push($fd, $msg) 会返回 false 且无报错。

正确做法是用 Swoole 提供的 Server->getClientInfo($fd) 验证 fd 是否存活，或改用 Server->exist($fd) 判断
更稳妥的是用「用户 ID → fd 映射表」存在 Swoole\Table 或 Redis 中，但映射键必须带 worker_id，例如 "uid:1002:worker_3"，推送前先查对应 worker 的 server 实例
TP 的 command 定时任务本质是 CLI 进程，无法直接调用 swoole_websocket_server 实例，需通过 Redis pub/sub 或 Unix Socket 中转指令

`onOpen` 里做数据库查询阻塞连接？用 `go()` 协程或异步 MySQL

WebSocket 握手完成触发 onOpen，此时若同步查 MySQL 或调用 TP 的 Db::table()->find()，整个 Worker 进程会被卡住，后续所有连接请求排队等待——性能崩塌点往往藏在这里。

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

禁用任何同步 I/O：包括 file_get_contents、curl_exec、TP 的 Http::get，它们都会让当前协程挂起
改用 Swoole 的 Co\Mysql 或 Co\Redis，或者用 go(function () { ... }) 包裹耗时操作，确保主线程不阻塞
ThinkPHP 8.0+ 的 think-swoole 扩展支持协程适配，但需确认 Db 驱动已切换为 swoole_mysql，否则 Db:: 调用仍是同步的

部署后 WebSocket 400 或 502？重点查 Nginx 的 Upgrade 头透传

生产环境走 Nginx 反代时，WebSocket 升级请求（Upgrade: websocket）被过滤或改写，导致握手失败。错误现象通常是浏览器控制台报 Failed to execute 'send' on 'WebSocket': Still in CONNECTING state，或 Nginx 日志里出现 upstream sent no valid HTTP/1.0 header。

Nginx 配置必须显式透传关键头：proxy_set_header Upgrade $http_upgrade; 和 proxy_set_header Connection "upgrade";
proxy_http_version 必须设为 1.1，否则 Upgrade 头无效；proxy_read_timeout 建议设为 300 以上，避免空闲连接被 Nginx 主动断开
如果用 CDN 或 WAF（如阿里云 DDoS 防护），确认其支持 WebSocket 协议升级，部分免费层会静默降级为 HTTP 短连接

真实线上环境里，WebSocket 和定时任务的耦合点从来不在代码多不多，而在于「谁在哪个进程里、数据在哪块内存里、头有没有被中间件吃掉」。这三个边界划不清，压测时连接数一上去，问题就不是报错，而是彻底静音。