Swoole WebSocket连接数怎么统计-Swoole-PHP中文网

最准的统计方式是直接读 $server->connections，它是内核级实时快照，v5.0+为channel类型，v4.x为迭代器，天然抗异常；需配合心跳检测、redis聚合与定时校验确保准确性。

swoole websocket连接数怎么统计

直接读 `$server->connections` 是最准的统计方式

在 Swoole 的 WebSocket 服务器中，$server->connections 是一个只读的 Swoole\Coroutine\Channel 类型（v5.0+）或数组式迭代器（v4.x），它实时反映当前所有已建立、未关闭的 WebSocket 连接对应的 fd。它不依赖心跳、不靠计数器增减，底层由 epoll/kqueue 状态驱动，只要连接还活着，就一定在里面。

常见错误是自己维护静态变量 $onlineCount：一旦 onClose 没触发（如客户端强杀进程、网络闪断）、或 onOpen 被重复调用（如重连未去重），数字立刻失真。而 $server->connections 是内核级快照，天然抗异常。

必须在 onOpen 或 onMessage 回调里调用，不能在协程外或定时器里直接遍历（v5.0+ 需 co::sleep(0) 让出调度）
v4.8+ 支持 count($server->connections)；v5.0+ 推荐用 $server->connections->length()，更明确且性能略优
注意：这个集合只含 WebSocket 连接，不包括普通 HTTP 请求或 TCP 连接

集群环境下不能只看单节点 `$server->connections`

单机部署时，count($server->connections) 就是真实在线数；但多台 Swoole 实例组成集群后，每个节点的 $server->connections 只反映本机连接，总人数必须聚合。

Redis 是最常用且可靠的聚合方案，不是因为“高级”，而是因为它解决了三个硬需求：原子性（INCR/DECR）、跨进程可见性、以及可主动探活（配合 TTL 剔除僵尸连接）。

在 onOpen 里执行 redis->incr('ws:total')，并给 key 设置 60 秒 TTL
在 onClose 里执行 redis->decr('ws:total')
另起一个定时任务（如每 10 秒），用 redis->keys('ws:fd:*') 扫描所有连接标识，比对 $server->connections 是否仍存活，不一致则补 DECR
避免用 Pub/Sub 广播连接数变更——它不保证送达，会导致前端显示滞后或跳变

`onClose` 不一定被调用，得靠心跳兜底

客户端关浏览器标签、杀 App、断网，服务端未必能立刻收到 onClose。Swoole 默认不会主动探测死连接，$server->connections 会残留失效 fd，导致统计虚高。

WebSocket 8.18.2

WebSocket 8.18.2 是该协议规范的一个重要迭代版本，主要优化了连接稳定性与数据传输效率。它通过全双工通信机制，允许客户端与服务器在单一长连接上实时交换数据，大幅降低传统 HTTP 轮询的开销。该版本增强了心跳保活、自动重连及二进制帧传输能力，适用于即时通讯、在线游戏及金融行情推送等低延迟场景，为开发者提供更可靠的实时网络交互基础。

下载

解决办法是开启 heartbeat_check_interval 并设置合理的 heartbeat_idle_time：

启动服务器时配置：$server->set(['heartbeat_check_interval' => 30, 'heartbeat_idle_time' => 60])
这会让 Swoole 每 30 秒 ping 所有连接，60 秒没 pong 就自动 close 并触发 onClose
务必确认客户端实现了 onpong 响应，否则心跳失败会被误判为断连
不要把 heartbeat_idle_time 设得太小（如