PHP OPcache 部署后旧代码仍在运行：脚本时间戳检查、重载时机与版本核对

代码已经传到服务器，接口却像没更新：同一个请求仍然返回旧字段，甚至只有重启 PHP-FPM 后才恢复。这个现象通常不是发布目录错了，而是 OPcache 还在复用旧脚本。排查时要把“文件是否更新”“FPM 进程加载了什么”“CLI 看到的缓存是否同一份”分开验证。

先确认：旧响应来自缓存还是错误目录

先在新代码里放一个短期可撤回的版本标记，例如响应头 X-App-Release: 20260826-rc1，或在内部诊断接口返回构建号。不要直接凭页面文案猜测，因为反向代理、浏览器缓存和 PHP-FPM 可能同时造成“看起来没更新”。

 '20260826-rc1'], JSON_UNESCAPED_UNICODE);

用同一条真实请求检查响应头。如果新标记始终不出现，再确认请求实际进入的 FPM 池、DocumentRoot 和发布软链接；这些都正确后，才进入 OPcache 配置判断。

三个配置值决定自动更新边界

opcache.validate_timestamps 开启时，OPcache 会周期性检查脚本是否变化；opcache.revalidate_freq 决定检查间隔，设为 0 表示每次请求检查。若前者关闭，后者不会单独解决旧代码问题。

; 开发或需要自动感知文件变化的环境
opcache.validate_timestamps=1
opcache.revalidate_freq=2

; 生产环境常见的发布策略：关闭自动检查，发布时明确重载
opcache.validate_timestamps=0

生产环境可以关闭时间戳检查，但发布脚本必须把“上传完成”和“FPM 重载完成”视为两个不同阶段。只替换文件、不重载服务，旧 worker 仍可能继续服务缓存中的脚本。

发布时选择重载、单文件失效还是全量重置

如果只是确认一个脚本需要重新编译，可以在与 Web 请求相同的 SAPI 环境中调用 opcache_invalidate()；如果发布涉及多个依赖文件，更稳妥的是让 PHP-FPM 按现有运维方式平滑重载，确保新 worker 使用新文件。

# 示例：先确认服务名，再按发行版实际服务执行平滑重载
sudo systemctl status php8.4-fpm
sudo systemctl reload php8.4-fpm

命令返回成功还不够。重载后必须重新访问真实入口，并读取版本标记；如果命令行里的 opcache_reset() 显示成功，却不影响网站响应，优先怀疑你重置的是 CLI 的缓存实例。

CLI、FPM 和容器里的配置可能不是同一份

php --ini 和 Web 页面里的 phpinfo() 可能指向不同配置文件。容器部署还要额外核对：新文件是否进入运行中的容器、FPM master 是否真的收到 reload、入口流量是否仍指向旧容器。

php --ini
php -i | grep -E 'opcache.enable|opcache.validate_timestamps|opcache.revalidate_freq'

这些命令只能说明 CLI 侧的配置。Web 侧应通过受保护的诊断端点读取 PHP_SAPI、PHP_VERSION 和相关 ini 值，诊断接口完成验收后立即移除或加权限。

常见误区与上线速查

• 只看 FTP 或发布目录的修改时间：这只能证明文件落盘，不代表 FPM worker 已加载。
• 把 revalidate_freq=0 当成关闭时间戳检查后的补救：该值在 validate_timestamps 关闭时不起作用。
• 在 CLI 执行缓存重置后直接宣布恢复：CLI 与 FPM 的 OPcache 实例相互独立。
• 只重启 Nginx：静态文件可能更新，但 PHP 字节码仍由 FPM 管理。

相关问题

为什么改了 php.ini 仍然没有生效？

先确认改的是 FPM 使用的配置，再重载或重启对应 PHP-FPM 服务；CLI 的 php -i 结果不能代表 FPM。

生产环境是否必须开启 validate_timestamps？

不是必须。关闭它可以减少检查开销，但必须把 FPM 重载或明确缓存失效纳入发布流程，并用真实 HTTP 响应验收。

opcache_reset() 能清掉所有请求进程的缓存吗？

它作用于调用它的 SAPI 缓存实例。要影响网站流量，调用位置必须属于实际提供请求的 FPM 环境，不能只在 CLI 中执行。

把“新代码已生效”变成可证明的发布结果

一套可靠记录至少包含四项：发布文件或软链接的版本、FPM 使用的配置、重载命令结果、真实 HTTP 请求中的版本标记。四项一致时，旧代码问题才算闭环；其中任何一项缺失，都不要用“刷新几次页面”代替验收。