Workerman怎么优雅关闭所有连接再停止服务-php教程-PHP中文网

workerman优雅关闭需先通知客户端即将断连、等待连接自然关闭并清理资源后退出。通过php start.php stop -g触发，主进程发sigterm信号，暂停新连接，监控活跃连接关闭；超时10秒强制关闭卡住连接；需注册sigterm/sigint回调、广播关闭通知、在onclose中清理资源，并显式exit(0)确保进程退出。

workerman怎么优雅关闭所有连接再停止服务

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 回调中广播“服务即将关闭”，给所有在线客户端发送提示消息

ClickPrompt

ClickPrompt是一款AI图像与设计工具，在线AI提示词设计工具。

下载

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 命令长时间无响应。