PHP 怎么PHP 热更新

本文目录导读：

1. 利用 PHP-FPM 的 reload 机制（最推荐）
2. 使用 OPcache 的 validate_timestamps 配置（开发/测试环境常用）
3. 使用 opcache_reset() 函数（受控热更新）
4. 通过符号链接切换（原子性部署，最安全的生产方案）
5. 使用 Swoole / Workerman 常驻内存（进阶方案）
6. 总结建议

PHP 本身是解释型语言，理论上不需要像编译型语言那样“重新编译”，但实际业务中，我们常说的“热更新”通常指在不重启 Web 服务器（如 Nginx + PHP-FPM）或中断服务的情况下，更新 PHP 代码并使其立即生效。

要实现高效的 PHP 热更新，核心思路是绕过 Opcode 缓存，并利用文件重命名的原子性操作。

以下是几种主流且安全的 PHP 热更新方案：

利用 PHP-FPM 的 reload 机制（最推荐）

PHP-FPM 支持平滑重启，当执行 reload 时，它不会中断正在处理的请求，而是处理完当前请求后，再启动新的 Worker 进程加载新代码。

• 适用场景：全新部署、大版本更新、修改了核心框架代码。

• 操作方式：

  # 平滑重载 PHP-FPM
  sudo kill -USR2 $(cat /var/run/php/php8.1-fpm.pid)
  # 或者 systemd 系统
  sudo systemctl reload php8.1-fpm

• 优点：官方支持，最稳定，不会出现请求中断。

• 缺点：严格来说不是“零停机”，因为要等当前请求结束（最多几秒），且无法做到毫秒级即时生效。

使用 OPcache 的 validate_timestamps 配置（开发/测试环境常用）

PHP 7+ 内置的 OPcache 会缓存编译后的 Opcode，默认情况下，它依赖文件修改时间（mtime）来判断是否重新编译。

• 配置（php.ini 或 php-fpm pool 配置）：

  opcache.enable=1
  opcache.validate_timestamps=1      ; 开启文件时间戳校验
  opcache.revalidate_freq=0          ; 设置为0，每次请求都检查文件是否修改
  opcache.max_accelerated_files=10000
  ; 注意：opcache.revalidate_freq=0 会略微降低性能，但能实现即时热更新

• 原理：每次请求时，PHP 检查文件是否被修改，如果修改了，就重新编译并替换缓存。
• 优点：代码修改后立即生效，无需任何命令。
• 缺点：不推荐生产环境使用，每次请求都检查文件状态，会浪费大量 I/O 和 CPU，生产环境通常设为 opcache.validate_timestamps=0 来提高性能。

使用 opcache_reset() 函数（受控热更新）

生产环境为了性能,通常会关闭 validate_timestamps，你可以通过一个受控的 HTTP 接口或 CLI 脚本来手动清空 OPcache。

• 配置（生产环境）：

  opcache.enable=1
  opcache.validate_timestamps=0   ; 关闭自动检查
  opcache.max_accelerated_files=10000

• 操作方法：

  1. 编写一个只允许内网访问的 PHP 文件（/path/to/opcache_reset.php）：

     <?php
     // 只允许来自本机或内网的请求
     if (in_array($_SERVER['REMOTE_ADDR'] ?? '', ['127.0.0.1', '内网IP'])) {
         opcache_reset(); // 清空所有 Opcode 缓存
         echo "OPcache 已重置";
     }

  2. 更新完代码后,curl 访问这个地址：

     curl http://内网地址/opcache_reset.php

通过符号链接切换（原子性部署，最安全的生产方案）

这是目前最流行的“热更新”方式（如 Deployer、GitLab CI/CD 常用模式），它不依赖 PHP 内部机制，而是利用 Linux 文件系统的原子性操作。

• 目录结构：

  /data/wwwroot/
  ├── releases/
  │   ├── 20230101_120000/   # 当前旧版本
  │   └── 20230102_140000/   # 刚刚上传的新版本
  └── current -> ./releases/20230102_140000   # 软链接指向当前版本

• 操作步骤：

  1. 上传代码：将新版本代码上传到 releases/20230102_140000 目录。

  2. 原子切换：执行 ln -sfn 命令更新软链接（这个操作是原子的）。

     # 瞬间将 current 指向新版本
     ln -sfn /data/wwwroot/releases/20230102_140000 /data/wwwroot/current
     # 然后重置 OPcache（因为软链接指向变了，文件路径没变，但 inode 变了）
     curl http://内网地址/opcache_reset.php

• 优点：

  • 真正的零停机：旧版本 PHP-FPM 进程处理完请求后，新请求已经指向新目录。
  • 轻松回滚：只需将软链接指向旧版本。
  • 安全：即使上传过程出错，也不会影响正在运行的旧版本。

• 注意：必须配合 opcache_reset()，因为 PHP 是通过文件路径（inode）来缓存 Opcode 的，软链接切换后，文件路径没变（还是 /data/wwwroot/current/app.php），但 inode 变了，OPcache 必须清空。

使用 Swoole / Workerman 常驻内存（进阶方案）

如果你的项目使用 Swoole 或 Workerman，它们会将 PHP 编译为 Opcode 并常驻内存，这时“热更新”是一个需要专门设计的工程问题。

• Swoole：通过 onWorkerReload 回调 + 自定义文件监控（如 inotify）实现。
• Workerman：支持 reload 命令，类似 PHP-FPM 但粒度更细。
• 缺点：架构复杂，内存泄漏不易排查。

总结建议

一个常见的误区：很多人以为上传文件覆盖就叫“热更新”，但这样会导致用户在访问间歇期读到不完整的文件（如果文件正在被写入）。最安全的做法是：先上传到临时目录，再通过符号链接切换到新目录。