ubuntu上thinkphp如何进行代码热更新

在Ubuntu上开发ThinkPHP应用，代码修改后如何快速生效，是很多开发者关心的问题。今天，我们就来聊聊几种实现“热更新”的实践方案，帮你提升开发效率。

选择哪种方案，首先得看你项目采用的运行模式。不同的模式，热更新的原理和实现路径截然不同。

一 运行模式与热更新原理

简单来说，可以分成两种情况：

• PHP-FPM模式：这是最传统的部署方式，由Nginx将请求转发给PHP-FPM进程处理。在这种模式下，代码文件是每次请求时动态解释执行的。所以，你修改了代码并保存后，下一次请求就会自动加载新文件，基本实现了“保存即生效”。当然，如果你修改了系统配置或引入了新的依赖，通常需要重启一下PHP-FPM服务（sudo systemctl restart php-fpm）才能完全生效。
• Swoole/Workerman常驻内存模式：当使用Think-Swoole这类扩展时，PHP进程会常驻内存，以处理多个请求。这带来了性能优势，但也带来了一个“副作用”：修改代码文件后，内存中的旧代码不会自动更新。这时，就需要触发进程重载。好在Think-Swoole框架内置了基于文件监控的自动重载能力，为开发调试提供了便利。

二 Swoole 常驻模式的热更新步骤（ThinkPHP 6）

如果你正在使用ThinkPHP 6结合Swoole进行开发，开启热更新其实并不复杂。

第一步：安装与启动

首先，通过Composer安装官方扩展：

composer require topthink/think-swoole

安装完成后，使用命令 php think swoole 即可启动服务。默认会监听80端口，如果遇到端口冲突，可以在 config/swoole.php 配置文件中进行调整。

第二步：开启热更新

开启热更新主要有两种方式：

1. 环境变量开启（推荐）：在项目根目录的 .env 文件中，设置 APP_DEBUG=true。在调试模式下，Think-Swoole默认会启用热更新功能，非常方便。
2. 配置文件显式开启：你也可以在 config/swoole.php 配置文件中进行更精细的控制。一个典型的配置示例如下：

'hot_update' => [
    'enable'  => true, // 启用热更新
    'name'    => '*.php', // 监控的文件类型
    'include' => [app_path()], // 监控的目录，通常为app目录
    'exclude' => [], // 排除的目录
]

重要提示：基于文件监控的热更新机制，会持续扫描文件系统，这在开发环境非常有用。但部署到生产环境时，务必关闭此功能。生产环境的代码更新，应通过灰度发布、滚动重启或手动执行reload命令来完成，以避免不必要的性能损耗和因文件意外变更引发的不可控重载。

三 FPM 模式下的文件变更感知与自动重启

对于使用PHP-FPM模式的项目，虽然代码修改本身能生效，但有时我们希望能实现“保存即重启”的自动化体验，尤其是在修改了配置或引入了新类时。这时，可以借助 inotifywait 工具。

它的原理是监听指定目录下的文件变更事件（如修改、创建、删除），一旦检测到变化，就自动向PHP-FPM主进程发送重载信号。

操作步骤如下：

1. 安装监控工具：sudo apt-get install inotify-tools
2. 创建监控脚本：将以下脚本保存为 watcher.sh，记得替换其中的项目路径和PHP-FPM PID文件路径。

#!/usr/bin/env bash
PHP_FILES="/var/www/your-tp-app/**/*.php"
PHPFPM_PID="/run/php/php8.1-fpm.pid" # 请根据实际环境调整PID文件路径

inotifywait -m -e modify,create,delete --format '%w%f' "$PHP_FILES" | while read FILE; do
    echo "File changed: $FILE, reloading PHP-FPM..."
    kill -USR2 "$(cat "$PHPFPM_PID")"
done

3. 运行脚本：给脚本添加执行权限，并在后台运行它。

chmod +x watcher.sh && nohup ./watcher.sh &

这里发送的 USR2 信号会触发PHP-FPM的“优雅重启”：主进程会重新加载配置和代码，并等待所有正在处理的子进程完成当前请求后再退出旧进程、启动新进程。这种方式对线上服务的影响较小，非常适合在开发或测试环境中使用。

四 使用进程管理器的开发便捷方案

另一个思路是借助进程管理器，比如Supervisor。它本身并不提供文件监控，但能确保你的应用进程在异常退出后自动重启。我们可以将它与其他工具结合，实现一种“变更后自动重启”的准热更新体验。

具体做法：

1. 安装Supervisor：sudo apt-get update && sudo apt-get install supervisor
2. 配置应用：在 /etc/supervisor/conf.d/ 目录下创建一个配置文件，例如 php.conf。

[program:thinkphp]
command=php /path/to/your/tp-project/think swoole start # 或你的启动命令
autostart=true
autorestart=true
user=www-data
redirect_stderr=true
stdout_logfile=/path/to/your/tp-project/runtime/log/supervisor.log

3. 启动与管理：让Supervisor读取新配置并启动应用。

sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl start thinkphp:*

这样一来，如果你的应用进程因为任何原因（包括你手动终止以加载新代码）停止，Supervisor都会立刻将其重新拉起来。如果配合前面提到的 inotifywait 脚本，在检测到文件变更时主动重启进程，就能在开发中获得更流畅的“变更即生效”体验。

五 生产环境建议

最后，必须强调一下生产环境的注意事项。长期在线上环境开启文件监控式的热更新是不推荐的，这既会带来额外的性能开销，也可能因监控意外触发导致服务不稳定。

对于生产环境，更稳妥的做法是：

• 如果使用PHP-FPM模式，代码发布后，通过发送 USR2 信号优雅重启FPM进程池。
• 如果使用Swoole常驻模式，应在发布后通过命令行手动执行 reload 命令来重载Worker进程。
• 无论哪种模式，都应结合成熟的部署策略，如蓝绿部署或滚动更新，确保在更新过程中服务不中断，并且具备快速回滚的能力。

总结一下，在Ubuntu上为ThinkPHP实现热更新，关键在于“对症下药”。分清开发与生产环境，匹配好项目的运行模式，选择最适合你的工具组合，就能在提升开发效率的同时，保障线上服务的稳定可靠。