如果您在ThinkPHP项目中集成Workerman以支持长连接通信，但服务无法稳定维持客户端连接或配置未生效，则可能是由于Worker实例初始化方式、事件回调缺失或心跳机制未启用所致。以下是实现长连接特性的关键配置步骤：
一、正确初始化Worker实例并启用长连接属性
Workerman默认不自动保持TCP连接，需显式设置连接对象的keepConnection属性为true，确保连接在无数据交互时仍处于活跃状态。该设置必须在onConnect回调中完成，否则连接可能在首次消息后被静默关闭。
1、在ThinkPHP的命令类（如app/command/WorkerServer.php）中创建Worker实例，协议使用tcp://或websocket://；
2、在$worker->onConnect回调内，对传入的$connection对象设置$connection->keepConnection = true；
立即学习“PHP免费学习笔记（深入）”；
3、确保onMessage回调中至少执行一次$connection->send()或完整读取数据，避免因空处理触发连接中断；
4、启动服务时使用守护进程模式：php think worker:server start -d，防止前台进程退出导致服务终止。
二、配置心跳检测与连接保活机制
仅启用keepConnection不足以应对NAT超时或防火墙主动断连，必须配合双向心跳机制定时刷新连接活跃状态。服务器端需记录每次通信时间，并通过定时器清理超时连接；客户端也需定期发送心跳包并监听响应。
1、在onConnect中为每个连接初始化$connection->lastMessageTime = time()；
2、在onMessage中更新该时间戳：$connection->lastMessageTime = time()；
3、使用Worker::addTimer(55, function () { … })每隔55秒遍历所有连接，关闭time() – $connection->lastMessageTime > 60的连接；
4、在onMessage中识别客户端心跳请求（如{"type":"ping"}），立即回发{"type":"pong"}响应；
5、确保客户端定时器间隔（如30秒）严格小于服务端超时阈值（如60秒），形成安全冗余。
三、调整最大连接数与系统资源限制
长连接服务的并发能力受限于Workerman应用层配置与操作系统文件描述符上限。若连接数增长到数千即出现拒绝或异常断开，需同步调整两级限制，否则任一环节瓶颈都将导致整体失效。
1、在Worker启动脚本开头设置全局最大连接数：Worker::$maxConnections = 100000；
2、针对特定Worker实例可单独设置：$worker->maxConnections = 50000，该值优先级高于全局配置；
3、检查当前系统限制：ulimit -n，若低于10万，需修改/etc/security/limits.conf并重启会话；
4、根据CPU核心数设置Worker进程数：$worker->count = 4（4核机器），避免过高数值引发上下文切换开销；
5、确认PHP未启用max_user_connections等数据库级连接限制干扰Worker主线程。
四、启用text协议并规范消息边界处理
使用text协议可简化换行分隔的消息解析，但TCP流式传输特性易导致粘包或拆包问题。若客户端发送多条消息合并到达或单条消息被截断，将造成业务逻辑错乱或连接中断。
1、在Worker构造后设置协议：Worker::$protocol = ‘text’；
2、要求客户端每条消息末尾必须携带\n或\r\n，服务端接收后用trim($data, "\r\n")统一清洗；
3、禁用二进制数据或含\0字节的内容，因text协议底层依赖explode("\n", $data)分割；
4、在onMessage中发送响应时，必须显式附加换行符：$connection->send("ack\n")，否则部分客户端（如Python makefile()）因行缓冲不触发输出；
5、若协议兼容性要求高，建议弃用Worker::$protocol，改用自定义缓存+按\n切分的完整解析逻辑。
五、使用Supervisor管理Worker进程生命周期
手动运行Worker易因终端关闭、异常退出或信号未捕获导致服务中断。生产环境必须借助进程管理工具实现自动拉起、日志归集与健康监控，确保长连接服务7×24小时持续可用。
1、安装Supervisor：apt install supervisor（Ubuntu/Debian）；
2、创建配置文件/etc/supervisor/conf.d/workerman.conf，内容包含command、directory、autostart、autorestart等字段；
3、指定用户为Web服务运行账户（如www-data），避免权限冲突；
4、重载配置：supervisorctl reread && supervisorctl update；
5、启动服务：supervisorctl start workerman，并验证进程状态与日志输出。
评论(0)