Swoole热更新功能如何实现不停机部署-Swoole-PHP中文网

swoole热更新生效需同时满足：opcache启用时间戳校验（validate_timestamps=1且revalidate_freq=0）、信号正确发送至master进程、业务代码在onworkerstart中动态require加载。

swoole热更新功能如何实现不停机部署

要在Swoole中实现真正意义上的不停机部署，必须绕过常驻内存导致的代码固化问题，让每次Worker重启都能加载磁盘最新代码，同时确保信号发给Master进程、opcache校验开启、业务入口动态加载三者全部到位。

确认Swoole热更新生效的三个硬性前提

第一步：检查opcache是否允许文件时间戳校验。打开php.ini，确认以下两项已设置：【opcache.validate_timestamps=1】且【opcache.revalidate_freq=0】。若只设前者而后者为默认值2，最多等待2秒才检测变更，会导致“改完代码等半天才生效”。

第二步：验证信号是否发给了Master进程而非Worker。用ps aux | grep swoole查出master pid（通常是最低的那个PID），执行kill -USR1 ；若误杀worker或用-HUP代替-USR1，reload()调用会静默失败。

第三步：确保业务逻辑在onWorkerStart中动态require。把控制器、服务类的加载逻辑写死在onStart或全局作用域里，reload后根本不会重新执行——这一步漏掉，90%的“热更新不生效”问题就源于此。

手动触发热更新的两种可靠方式

方法一：调用PHP层reload接口
在Swoole Server实例启动后，任意位置调用$server->reload()。该方法返回true仅表示信号已发出，不代表代码已重载，必须配合前述三个前提才有效。

方法二：终端发送系统信号
先获取Master进程PID：cat /path/to/swoole.pid（或ps aux | grep 'php serve.php' | head -1 | awk '{print $2}'）→ 执行kill -USR1 。注意：不能用killall php，会误杀其他PHP进程。

自动监听文件变更并触发reload

第一步：安装inotify-tools（Ubuntu/Debian运行sudo apt-get install inotify-tools；CentOS运行sudo yum install inotify-tools）

Swoole 6.1.1

Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。

下载

第二步：编写监听脚本watch.sh，内容如下：

#!/bin/bash
INOTIFY_PATH="./app ./config ./route"
while true; do
  inotifywait -e modify,create,delete,move -m $INOTIFY_PATH > /dev/null 2>&1 &
  PID=$!
  wait $PID
  kill -USR1 $(cat /path/to/swoole.pid)
done

第三步：赋予执行权限并后台运行：chmod +x watch.sh → nohup ./watch.sh &

【注意：此脚本监听路径不可随意扩展到vendor/或runtime/目录，否则composer update或日志写入会频繁触发reload，压垮服务】