PHP 8.2 线上开了 opcache 改代码不生效怎么排查缓存

现象

线上 PHP 8.2 项目更新了一个控制器,页面刷新多次仍是旧逻辑,日志里也没有新加的调试输出。重启 php-fpm 后立刻正常,过一段时间再次发布又复现。opcache_get_status 显示缓存命中率很高,但脚本时间戳没有变化。

原因

OPcache 把编译后的字节码放在共享内存里,是否检查源文件变化由 validate_timestamps 控制。该值为 0 时只在进程启动时编译一次,之后完全不看文件时间;revalidate_freq 设得过大也会让修改延迟生效。另一种情况是发布时换了新目录,但 FPM 还在用旧路径的缓存。

解决步骤

第一步,确认 opcache 的实际参数。分别查看 FPM 的 enable、validate_timestamps 和 revalidate_freq,注意 conf.d 下后加载的文件可能覆盖主配置。

php -i | grep -E 'opcache.enable|validate_timestamps|revalidate_freq'
php -r "print_r(opcache_get_status()['opcache_statistics']);"

第二步,按发布方式调整策略。开发机保持 validate_timestamps=1、revalidate_freq=2;生产环境可以关掉校验,但发布流程必须在最后一步重载 FPM 或调用 opcache_reset,不能只替换文件。

opcache.validate_timestamps=1
opcache.revalidate_freq=2
opcache.max_accelerated_files=20000
systemctl reload php8.2-fpm

第三步,检查发布目录和 CLI 差异。确认 Nginx 的 root 指向的目录就是 FPM 实际执行的目录,软链接切换后要 realpath 一致;命令行验证不经过 FPM 的缓存,不能用它判断线上是否生效。

验证

修改模板或控制器后不重启服务,几秒内刷新即可看到新内容;opcache_get_status 里 cached_scripts 数量随发布变化,脚本时间戳更新。

小结

改了代码不生效先查 OPcache,而不是怀疑框架缓存。按环境决定是否校验时间戳,并保证每次发布都让缓存失效。

您可以还会对下面的文章感兴趣: