OPcache 需确认在 Web SAPI 下加载且启用：先通过 phpinfo() 查“Loaded Configuration File”和“Opcode Caching”状态，再验证 opcache_get_status() 是否可用；宝塔等环境需正确配置 zend_extension=opcache.so 及关键参数（如 memory_consumption=256、max_accelerated_files=20000），并重启 PHP-FPM；Windows 下须用绝对路径指定 DLL；生产环境应设 validate_timestamps=1 与 revalidate_freq=5 平衡性能与更新及时性。
确认 OPcache 是否已加载且启用
很多人改完 php.ini 就以为开成功了，结果请求还是慢——根本原因是 OPcache 根本没加载。PHP 有 CLI 和 Web（如 FPM/Apache）两套配置，php -m | grep opcache 看的是 CLI 的模块列表，而网站跑的是 Web SAPI，可能压根没读你改的那个 php.ini。
- 先用
phpinfo()页面查 “Loaded Configuration File”，确认你编辑的是 Web 环境真正加载的文件 - 再搜索页面里有没有 “Opcode Caching” 区块，状态必须是 Enabled，且 “opcache.enable” 显示 On
- 若只有 CLI 下能
php -r "print_r(opcache_get_status());"成功，Web 下报错Call to undefined function opcache_get_status()，说明扩展没在 Web 模式下加载
Linux / 宝塔环境下启用并调参的关键操作
宝塔用户别急着点“一键开启”，它默认配的 opcache.max_accelerated_files=10000 对 Laravel 或含大量 Composer vendor 的项目远远不够，缓存会频繁踢出旧脚本，命中率掉到 40% 以下，反而拖慢性能。
- 在宝塔 PHP 8.4 设置页 → “配置修改”，找到
[opcache]区块或手动添加 - 确保有这行：
zend_extension=opcache.so（不是extension=opcache.so，后者无效） - 核心参数建议（中大型项目）：
opcache.enable=1opcache.memory_consumption=256opcache.max_accelerated_files=20000opcache.validate_timestamps=1opcache.revalidate_freq=60 - 改完必须执行
sudo systemctl restart php84-fpm（服务名以宝塔实际显示为准），只重启 Nginx 不生效
Windows 或本地开发环境常见失效原因
Windows 下最常卡在 DLL 路径错误：XAMPP/WAMP 默认 php.ini 里写的是 zend_extension=php_opcache.dll，但实际文件可能在 ext\php_opcache.dll，而 PHP 找不到就静默失败。
- 打开
php.ini，把zend_extension改成绝对路径，例如：zend_extension="C:\xampp\php\ext\php_opcache.dll" - 开发时务必保持
opcache.validate_timestamps=1，否则改一行代码刷新页面还是旧逻辑 -
opcache.revalidate_freq=0在 Windows 上尤其危险：有些 IDE 保存文件不更新时间戳，会导致 OPcache 永远不重载，只能靠重启 Apache 或手动调opcache_reset() - 验证时别只信
phpinfo()，要跑opcache_get_status()看opcache_enabled是 true，且opcache_statistics.hits在持续增长
上线后代码不更新？不是缓存 HTML，是 OPcache 没“闻到”变化
典型现象：rsync 部署完新版本，页面白屏或报 Class 'XXX' not found。这不是 CDN 或浏览器缓存问题，而是 OPcache 还在用旧字节码——因为 opcache.validate_timestamps=0 时，它彻底放弃检查文件是否改动。
立即学习“PHP免费学习笔记（深入）”；
- 生产环境推荐组合：
opcache.validate_timestamps=1+opcache.revalidate_freq=5（非零值），既避免每次请求都 IO，又保证发布后几秒内生效 - 若用容器部署或只读文件系统，必须关掉时间戳验证，那就得在发布脚本里加一步：
php -r "opcache_reset();" - 某些云平台（如阿里云 FC）禁用
opcache_reset()，此时唯一办法是滚动重启 PHP-FPM 进程，或改用opcache_invalidate('path/to/file.php', true)单文件刷新
OPcache 不是设个 enable=1 就万事大吉的开关，它的内存分配、文件数上限、时间戳策略三者稍有不匹配，就会从加速器变成阻塞器——尤其是高并发场景下，缓存未命中引发的编译风暴比不开还伤。
