workerman服务需确保批量推送消息全部投递后再停止:先注册sigterm/sigint处理器并设shouldstop标记,禁止新连接;再轮询检测所有连接写缓冲为空后调用stopall();同时需通过connectionmanager管理连接状态,并将推送任务队列化配合异步信号处理。

当Workerman服务正在向客户端批量推送消息时,需要立即停止服务但又不能丢弃已进入队列但尚未发送的消息,必须确保所有待发消息完成投递后再终止进程。
监听系统信号并延迟关闭
第一步:在Worker启动后注册SIGTERM和SIGINT信号处理器,捕获外部终止指令。
第二步:收到信号后,先设置全局标记$worker->shouldStop = true,禁止新连接接入,但不立即调用Worker::stopAll()。
第三步:检查当前是否有待发送消息——遍历所有连接,若$connection->isWriting()为true或连接缓冲区非空,则等待其自然清空;这一步不可跳过,否则强制退出会丢弃write buffer中的数据。
第四步:使用Timer::add(100, function() use ($worker) { ... }, null, false)轮询检测所有连接是否空闲,一旦确认全部send()完成且无pending write,再执行Worker::stopAll()。
使用ConnectionManager统一管理连接状态
方法一:引入连接管理单例,在onMessage和onClose中同步更新连接状态。
方法二:在onWorkerStop回调中遍历$worker->connections,对每个连接调用$connection->send()前先判断if (!$connection->isClosed() && $connection->getWriteBufferCount() === 0),避免向已断开连接写入失败。
【关键前提】必须在onClose中主动调用ConnectionManager::getInstance()->remove($uid, $connection->id),否则$worker->connections残留无效引用,导致getWriteBufferCount()始终返回错误值。
推送任务队列化并监听退出信号
将待推送消息写入内存队列(如SplQueue),由独立Timer消费。当收到SIGTERM时,立即停止新消息入队,但允许当前Timer循环继续执行直至队列为空。
这一步必须配合pcntl_signal_dispatch()手动触发信号处理,因为Workerman默认禁用PHP原生信号调度;在onWorkerStart中添加pcntl_async_signals(true)启用异步信号。
最后在队列清空后调用Worker::stopAll(),此时所有消息已通过$connection->send()提交至内核socket缓冲区,操作系统会负责完成最终投递。











