Workerman优雅关闭需先通知客户端即将断连、等待连接自然关闭并清理资源后退出。通过php start.php stop -g触发，主进程发SIGTERM信号，暂停新连接，监控活跃连接关闭；超时10秒强制关闭卡住连接；需注册SIGTERM/SIGINT回调、广播关闭通知、在onClose中清理资源，并显式exit(0)确保进程退出。
Workerman优雅关闭所有连接再停止服务，是指在不中断正在处理的请求、不丢弃未完成数据的前提下，主动通知客户端即将断连、等待现有连接自然关闭、清理资源后退出进程。这一步必须在收到终止信号后触发，不能直接杀进程。
使用 -g 参数触发优雅停止
执行带 【-g】 选项的 stop 命令，Workerman 主进程会向所有 Worker 子进程发送 SIGTERM 信号，并进入等待状态。
php start.php stop -g
该命令不会立即退出，而是暂停接受新连接，同时监控所有活跃连接是否已关闭。只有当所有连接的 onclose 事件全部触发完毕、所有定时器和异步任务清空后，进程才真正退出。若某连接卡住（比如长轮询未响应），默认超时时间为 10 秒，超时后强制关闭该连接并继续退出流程。
手动注册 SIGTERM/SIGINT 信号回调
方法一：在 Worker 启动前注册信号处理器，确保主进程能捕获系统终止信号
在 start.php 文件顶部或 Worker 初始化之前加入：
pcntl_signal(SIGTERM, function () {
echo "SIGTERM received, initiating graceful shutdown\n";
Worker::$pidFile = ''; // 清理 pid 文件避免残留
foreach (Worker::getAllWorkers() as $worker) {
$worker->stop(); // 触发每个 worker 的优雅关闭逻辑
}
});
pcntl_signal(SIGINT, 'pcntl_signal_dispatch');
注意：pcntl_signal_dispatch() 必须在事件循环中周期调用，否则信号不会被实际处理。Workerman 内部已在 event loop 中自动调用，无需额外添加。
主动广播关闭通知并遍历关闭连接
第一步：在 onWorkerStop 回调中广播“服务即将关闭”，给所有在线客户端发送提示消息
Worker::onWorkerStop = function ($worker) {
foreach ($worker->connections as $connection) {
if ($connection->isConnected()) {
$connection->send('{"event":"server_shutdown","delay":5000}');
}
}
};
第二步：设置连接层超时，在 onMessage 或心跳检测中识别关闭指令
第三步：在 onClose 回调中清理该连接绑定的资源（如 Redis 订阅、数据库事务、临时文件）
第四步：确认所有连接 close 完成后，调用 exit(0) 显式退出当前 worker 进程
这一步必须做，否则 Worker 进程可能因事件循环未退出而卡住，导致 stop -g 命令长时间无响应。
验证优雅关闭是否生效
启动服务时加 -d 参数后台运行，再用以下命令观察日志行为：
tail -f workerman.log
执行 php start.php stop -g 后，日志中应依次出现：
“Graceful stop started” → “Sending shutdown notice to 12 clients” → “All connections closed” → “Worker stopped”
若日志卡在“Sending shutdown notice…”且无后续，说明有连接未触发 onClose，需检查该连接是否被异常阻塞（如死循环、未关闭的 stream、未释放的协程）。
