opcache.enable 配置项必须设置为 1 才能启用 OPcache，但仅开启该项无法直接最大化命中率。最大化命中率需要配合调整内存大小、文件数量上限及验证频率，并确保生产环境代码发布策略与缓存失效机制匹配。
先说结论：opcache.enable 设为 1 是基础，命中率高低取决于内存容量、文件上限和重验证频率的综合配置。
- 适合：PHP 生产环境、高并发 Web 服务、代码变更频率低的场景
- 先准备：确认 php.ini 路径、备份原配置、规划内存配额
- 验收：通过 opcache_get_status 函数检查命中率数值和缓存占用
命令速用版
使用以下命令快速查找 php.ini 位置并确认 OPcache 模块是否加载。
php `--ini` | grep "Loaded Configuration File"
php -m | grep opcache若未加载 opcache 模块，需在 php.ini 中添加 extension=opcache 并重启服务。
为什么会这样
opcache.enable 仅控制缓存开关，命中率受限于缓存容量和文件过期策略。OPcache 将编译后的脚本字节码存储在共享内存中，若内存不足或文件数量超过上限，旧缓存会被剔除，导致命中率下降。此外，若 revalidate_freq 设置过短，PHP 会频繁检查文件修改时间，增加开销并降低有效缓存利用率。
分步处理
第一步：定位并编辑 php.ini 文件，找到 opcache.enable 配置项。
opcache.enable=1第二步：调整内存消耗限制，避免缓存过早被填满。公开资料中没有看到可靠的量化数据表明具体数值，建议根据项目文件数量调整。
opcache.memory_consumption=128
opcache.max_accelerated_files=4000第三步：设置重验证频率，生产环境建议延长检查间隔。
opcache.revalidate_freq=60第四步：重启 PHP-FPM 或 Web 服务器使配置生效。
systemctl restart php-fpm
# 或
service apache2 restart怎么验证是否生效
创建 PHP 脚本调用 opcache_get_status 函数，查看 opcache_statistics 数组中的 hit_rate 字段。
<?php
print_r(opcache_get_status());
?>检查返回数组中的 memory_usage 是否接近上限，若 used_memory 接近 total_memory，说明需要增加 opcache.memory_consumption。观察 hit_rate 值，生产环境稳定运行后该值应保持在较高水平，公开资料中没有看到可靠的量化数据定义具体阈值。
常见坑
第一，CLI 与 Web 环境配置分离。opcache.enable 默认仅对 Web SAPI 生效，命令行脚本需额外设置 opcache.enable_cli=1。
第二，代码发布后缓存未清除。修改代码后若未重启服务或手动重置缓存，旧字节码可能继续运行。建议在部署脚本中加入 opcache_reset 调用。
第三，内存权限问题。若共享内存无法分配，OPcache 会 silently fail。检查系统日志中是否有 opcache 相关的警告信息。
常见问题
opcache.enable 设置为 0 会怎样
OPcache 扩展虽加载但不会缓存任何脚本，每次请求都会重新编译 PHP 文件，导致 CPU 占用升高。
如何手动清除 OPcache 缓存
在 PHP 脚本中调用 opcache_reset 函数可清空所有缓存，或重启 PHP-FPM 服务。
命中率低一定是配置问题吗
不一定。若项目文件数量极少或请求量不足，命中率数值参考意义有限；若频繁发布代码，缓存会不断失效。
参考来源
- PHP Manual, opcache.configuration, https://www.php.net/manual/en/opcache.configuration.php
- PHP Manual, opcache.functions, https://www.php.net/manual/en/ref.opcache.php