如何用Workerman开发支持断线自动重连的即时通讯SDK？-php教程-PHP中文网

Workerman服务端不自动重连，需客户端实现重连并服务端配合会话管理；须用client_id+connection_id双标识、Redis Hash存储带过期时间的会话、握手阶段校验认证包、定时心跳检测与清理。

如何用workerman开发支持断线自动重连的即时通讯sdk？

Workerman连接断开后不会自动重连，必须手动实现

Workerman本身是常驻内存的PHP进程框架，Worker 启动后会持续运行，但客户端（如浏览器 WebSocket 或移动端长连接）断线时，onClose 会被触发，而服务端不会“感知”到重连需求——它根本不知道客户端要回来。所谓“自动重连”，本质是客户端行为；服务端只需保证连接建立逻辑健壮、会话可恢复、不因重复连接出错即可。

常见错误现象：onConnect 中未校验重复登录导致旧连接残留、onClose 未清理关联资源（如 Redis 订阅、定时器）、客户端反复重连却不断开旧连接，最终耗尽 worker 进程的 socket 句柄或内存。

所有新连接必须带唯一 client_id（如 UUID 或设备+用户组合），服务端用 $connection->id + client_id 双维度标识会话
在 onConnect 中查 Redis 判断该 client_id 是否已在线，若存在则主动 close 旧连接（避免“一账号多端互踢”逻辑失效）
在 onClose 中务必调用 unset($this->clients[$client_id]) 并删除 Redis 中对应 key，否则下次重连时会误判为“已在线”

WebSocket连接中如何安全传递和校验client_id？

不能依赖 URL 参数传 client_id（易被篡改、不支持二进制协议），也不能在 onMessage 首帧才发（此时连接已建立，无法拒绝非法接入）。正确做法是在 WebSocket 握手阶段通过 onWebSocketConnect 拦截并解析 Sec-WebSocket-Key 外的自定义 header，或更稳妥地：强制客户端在首次 onMessage 必须发送带签名的认证包。

使用场景：SDK 初始化后第一帧消息必须是 {"type":"auth","token":"xxx","client_id":"xxx"}，服务端验证通过才接受后续消息，否则立即 $connection->close()。

Token 应含时间戳和签名（如 HMAC-SHA256(client_id + timestamp + $secret)），防重放
验证失败时不要返回错误详情，只关闭连接，避免暴露校验逻辑
校验通过后把 client_id 绑定到 $connection 实例上：$connection->client_id = $data['client_id'];

心跳超时与客户端重连策略必须协同设计

Workerman 默认不处理心跳，ping/pong 需手动收发。如果只靠客户端单方面发 ping，服务端不响应 pong 或不检测超时，连接可能长时间假死（TCP 层未断，但业务层已不可用）。

挖错网

一款面向内容审核与校对的智能检测平台，可对文本、图片和视频内容进行纠错检查，并提供AIGC相关检测能力。

下载

性能影响：频繁心跳会增加连接负载；心跳间隔过长又会导致故障发现延迟。建议服务端每 30 秒发一次 ping，客户端收到后必须回 pong；若 60 秒内无响应，服务端主动 close 连接。

在 onConnect 中启动定时器：$connection->ping_timer = Timer::add(30, [$connection, 'send'], ['ping']);
在 onMessage 中识别 pong 并清除上次 ping 的标记（可用 $connection->last_pong = time() 记录）
在 onClose 中用 Timer::del($connection->ping_timer) 清理定时器，防止内存泄漏