90%代码更新后线上未生效是opcache未校验时间戳所致，需确认phpinfo中opcache.validate_timestamps=1且revalidate_freq合理，并用error_log或opcache_invalidate验证。
代码改了但线上没变，90% 是 OPcache 还在执行内存里的旧字节码，不是文件没传、也不是框架缓存没清。
怎么确认真是 OPcache 搞的鬼
别猜，直接验证：访问一个 phpinfo() 页面，在输出里搜 Zend OPcache。如果状态是 enabled，且 opcache.validate_timestamps 显示为 Off 或值为 0，基本就是它了。再补一刀：在你要调试的 PHP 文件里加一行 error_log('hit me');，然后查 PHP 错误日志——没输出？说明根本没运行新文件，只跑了缓存里的旧版本。
为什么 opcache.revalidate_freq=2 会导致“等半分钟才生效”
这个参数不是“每 2 秒检查一次”，而是“最多每隔 2 秒检查一次，且仅当请求命中该脚本时才触发”。也就是说：你改完代码，但接下来 10 秒没人访问那个页面，OPcache 就完全不检查；哪怕有人访问了，也得等下一个检查窗口到来才可能发现变化。更坑的是，很多宝塔/Oneinstack 脚本默认把它设成 60 或 300，上线后你刷新十次都白搭。
-
opcache.validate_timestamps=1是开关，必须为 1 才启用时间戳检查 -
opcache.revalidate_freq=0表示每次请求都校验（开发/预发环境安全） -
opcache.revalidate_freq=2是生产常用折中，但发布后需手动干预 - 改完配置后，
systemctl reload php*-fpm不生效，必须restart或调用opcache_reset()
为什么重启 PHP-FPM 有时也不管用
因为服务器上可能有多个 PHP 版本共存，而你改的是 CLI 的 php.ini，网站跑的是 FPM 的另一份配置。执行 php --ini 看到的路径，和 phpinfo() 里显示的 Loaded Configuration File 常常不一致。尤其宝塔用户，面板里点开的“PHP 配置”链接，大概率指向 /www/server/php/83/etc/php.ini.bak 这类备份文件。
- 先用
phpinfo()找出真实生效的php.ini路径 - 用
cat /path/to/php.ini | grep -E "(opcache|zend_extension)"确认三要素：zend_extension=opcache.so、opcache.enable=1、opcache.validate_timestamps=1 - 修改后必须
systemctl restart php8.3-fpm（注意版本号），reload不会重载扩展 - TP5/Laravel 等框架还要顺手清掉
runtime/或storage/framework/views/，否则框架层缓存和 OPcache 两层旧东西一起生效
临时救急：用 opcache_invalidate() 精准清理单个文件
比全量 opcache_reset() 更轻量，适合灰度发布或只改了一个控制器的场景。但它有个硬限制：只能清理当前请求上下文里已加载过的脚本。所以不能写在 CLI 脚本里跑，得通过 HTTP 请求触发。
<?php // deploy-clear.php，放 web 可访问目录，用完删掉或加 IP 限制
$file = $_GET['file'] ?? '';
if (file_exists($file) && is_file($file)) {
if (opcache_invalidate($file, true)) {
echo "OK: {$file} invalidated";
} else {
echo "FAIL: opcache_invalidate failed";
}
} else {
echo "File not found";
}
?>
- 调用方式：
curl "https://yoursite.com/deploy-clear.php?file=/www/wwwroot/app/Controller/User.php" - 注意路径必须是绝对路径，且和
opcache_get_status()['scripts']里显示的full_path完全一致（符号链接会被展开） - 若返回 false，先检查
opcache.enable_cli是否为 0（Web 环境不影响），再确认文件是否真被 OPcache 加载过
最常被忽略的点：OPcache 缓存的是编译后的字节码，不是源码本身。它不关心你改了注释还是空格，只认文件修改时间戳——而这个时间戳检查机制，又依赖于 validate_timestamps 和 revalidate_freq 的组合行为。你以为改完就生效，其实只是还没轮到它看一眼。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
