ThinkPHP 本身不内置热更新,但通过 think-swoole 可实现文件监听+平滑 reload:修改 app/ 等目录下 PHP 文件后,inotify 检测变更并发送 SIGUSR1 信号触发 Swoole $server->reload() 仅重启 Worker 进程,不中断服务。
ThinkPHP 本身不内置热更新(Hot Reload)能力,但通过生态扩展(如 think-swoole)或搭配 Swoole 运行时,可实现开发阶段的「代码修改后自动重载 Worker 进程」效果——这常被开发者称为“热更新”,实际是文件监听 + 平滑 reload,不是 PHP 层面的字节码热替换。
hot_update 是怎么工作的?它依赖 Swoole 的 $server->reload() 接口,只重启 Worker 进程,不重启 Master,因此 HTTP 服务几乎不中断。
.env 中设 APP_DEBUG=true),且未显式关闭app/、config/、route/、provider/ 等(具体见 config/swoole.php 的 hot_update.watch_dirs).php 文件后,watcher 检测到变更 → 向 Swoole 主进程发 SIGUSR1 → 触发 reload()
public/ 下的静态资源、.env 或 runtime/ 不在默认监听范围内inotifywait -m -r -e modify,create,delete ./app --format '%w%f' | while read file; do [[ $file == *.php ]] && kill -USR1 $(cat runtime/swoole.pid) 2>/dev/null done
不是所有修改都会触发重载,尤其容易忽略以下几点:
hot_update.enable 在 config/swoole.php 中被设为 false(即使 APP_DEBUG=true 也会被覆盖)extend/ 下写了新服务类,但该目录不在 watch_dirs 列表里opcac
he.enable=1 且未配置 opcache.validate_timestamps=1,导致 PHP 缓存旧字节码,reload 后仍执行旧逻辑daemonize => false),某些终端环境下信号无法正确送达runtime/swoole.pid 文件权限不对或路径错误,导致脚本找不到主进程 PID不能。这是根本性不兼容:
think-swoole 是为 Swoole Server 设计的,依赖 Swoole\Http\Server 实例和进程模型reload()
/www/site → /www/releases/20260113)sudo systemctl reload php-fpm)opcache.revalidate_freq=0)让脚本每次检查时间戳不要。生产环境应严格禁用:
真正需要的不是“自动 reload”,而是「可控、可回滚、可观测」的发布机制——比如用 Docker 镜像 + 标签版本 + Kubernetes rolling update。
Swoole 的 reload 很快,但快不等于安全;开发图省事可以开,上线前务必关掉 hot_update.enable。