在使用 Swoole 构建的服务器应用中，优雅关闭（Graceful Shutdown）是指在不中断正在处理的请求、有序释放资源的前提下停止服务。这能避免客户端连接突然断开、数据丢失或写入不完整等问题。实现优雅关闭的关键在于正确处理信号、等待现有连接完成，并主动关闭所有活跃连接。

监听退出信号并触发关闭逻辑

Swoole 服务器运行在事件循环中，默认不会响应 Ctrl+C 或 kill 命令立即退出。要实现优雅关闭，需注册信号处理器，在收到终止信号时启动清理流程。

常用信号包括：

• SIGTERM：标准终止信号，用于请求程序正常退出。
• SIGINT：通常由 Ctrl+C 触发。

示例代码：

$server->on('WorkerStart', function ($server, $workerId) {
    if ($workerId === 0) { // 只在主工作进程中监听
        pcntl_signal(SIGTERM, function () use ($server) {
            echo "收到 SIGTERM，开始优雅关闭...\n";
            $server->shutdown();
        });
        pcntl_signal(SIGINT, function () use ($server) {
            echo "收到 SIGINT，开始优雅关闭...\n";
            $server->shutdown();
        });
    }
});

// 在主进程或管理进程中也可监听
Swoole\Process::signal(SIGTERM, function () use ($server) {
    $server->shutdown();
});

调用 shutdown() 并等待连接自然结束

$server->shutdown() 是 Swoole 提供的优雅关闭方法。它会：

• 关闭服务器监听端口，不再接受新连接。
• 保留已建立的连接和正在进行的任务，等待其自然完成。

注意：shutdown() 不会强制断开现有连接，适合配合连接超时机制使用。

若希望更彻底地控制关闭过程，可在 shutdown() 后手动遍历并关闭连接：

$server->shutdown();

// 可选：延迟一段时间，等待连接自动关闭
$timer = swoole_timer_after(5000, function () use ($server) {
    foreach ($server->connections as $fd) {
        if ($server->exists($fd)) {
            $server->close($fd);
        }
    }
    echo "所有连接已关闭。\n";
});

处理长连接与心跳机制

对于 WebSocket 或 TCP 长连接服务，客户端可能长时间保持在线。此时仅靠 shutdown() 可能无法及时释放资源。

建议做法：

• 在收到关闭信号后，向所有客户端发送“服务即将关闭”通知。
• 设置合理的最大等待时间，超时后强制关闭。
• 利用心跳检测空闲连接，提前清理无效会话。

示例：广播关闭通知

foreach ($server->connections as $fd) {
    if ($server->isEstablished($fd)) {
        $server->push($fd, json_encode(['type' => 'closing', 'msg' => '服务即将关闭']));
    }
}

清理定时器与异步任务

如果服务中使用了定时器或异步任务，应在关闭前清除它们，防止残留执行。

// 清理所有定时器
swoole_timer_clear_all();

// 或记录 timer_id，按需清除
if (isset($this->heartbeatTimer)) {
    swoole_timer_clear($this->heartbeatTimer);
}

基本上就这些。关键是通过信号监听触发 shutdown()，配合连接遍历、通知广播和资源清理，实现真正优雅的退出。不复杂但容易忽略细节。