1. 配置基础与启用
1.1 启用 OPcache
在 PHP 7 及以上版本中，OPcache 已内置并可直接启用，开启后可以显著减少字节码的重复编译时间，从而提升每个请求的吞吐量。核心要点是确保在生产环境中权衡稳定性与性能，避免不必要的额外校验造成开销。
通过在 php.ini 或运行时设置 opcache.enable、opcache.enable_cli，可以实现 Web 与 CLI 的缓存行为分离。修改后请重启相应的 PHP 服务（如 PHP-FPM/Apache），以确保新配置生效。
; 开启 OPcache
opcache.enable=1
opcache.enable_cli=0
opcache.interned_strings_buffer=8
opcache.memory_consumption=128
opcache.max_accelerated_files=10000
opcache.validate_timestamps=1
opcache.revalidate_freq=2
1.2 环境版本与兼容性
选择兼容的 PHP 版本与 OPcache 版本，通常较新的 PHP 版本带来更好的字节码缓存策略与安全修复，因此应在测试环境验证后再上线生产环境。版本匹配很关键，以避免不可预期的行为。
在多进程/多服务器部署中，为避免缓存数据不一致，确保 OPcache 配置在各节点一致，可将 opcache.file_cache 指向集中目录，但需注意并发写入的锁竞争。
2. 调整关键参数以提升性能
2.1 opcache.memory_consumption
这是最重要的性能调优项之一。足够的内存用于缓存已编译的字节码，可以显著降低重复编译的开销。常见起步值为 128–256MB，若应用规模较大或框架繁多，可考虑提升到 256–512MB。
需关注“内存并非越大越好”，超过服务器实际物理内存会增加换页与 GC 开销，因此应结合服务器并发与总内存进行估算，并动态监控使用情况以调整。
; 内存分配示例
opcache.memory_consumption=256
opcache.interned_strings_buffer=16
2.2 opcache.interned_strings_buffer
interned_strings_buffer 用于缓存已解析的字符串，增大此值可减少重复字符串比较的开销，尤其在字符串常量较多的应用中效果明显。默认值 8 可能不足，提升到 16 或 32 更能体现收益。
对于高并发或大型应用，应监控总内存占用并根据实际情况扩展缓冲区，避免对总体内存造成压力。
opcache.interned_strings_buffer=16
2.3 其他关键参数
opcache.max_accelerated_files 用于控制最多缓存的脚本数量，需要针对大型应用设定较高上限，但要与内存约束相匹配。opcache.validate_timestamps 与 opcache.revalidate_freq 决定缓存的有效性检测策略，生产环境通常在应用版本更新较少时考虑降低检查频率，以减少缓存重建开销。
通过合理组合，可以在不牺牲应用更新速度的前提下，获得更稳定的缓存命中率。
opcache.max_accelerated_files=20000
opcache.validate_timestamps=0
opcache.revalidate_freq=0
3. 监控与诊断性能
3.1 使用 opcache_get_status()
opcache_get_status() 提供当前缓存状态的全貌，包括 已缓存脚本数量、缓存命中率、内存使用情况等关键指标，是判断是否达到预期性能的核心入口。定期采集并记录状态，有助于发现趋势性问题。
在生产环境中，结合日志与监控面板进行可视化展示，可以快速定位命中率下降、缓存容量不足等问题。
3.2 指标解读与优化动作
关注的核心指标包括 memory_usage、scripts cached、hits 与 misses 等统计信息。命中率长期稳定在高位通常表示配置良好。
如果观察到命中率偏低，应检查 热代码的缓存命中情况、缓存失效策略、以及 自动加载路径的稳定性，并结合日志与压力测试进行调整。
4. 在Web与CLI环境中的差异与优化
4.1 Web 场景的优化要点
Web 请求通常并发量高、脚本生命周期短，因此需要确保 OPcache 处于持续缓存状态，并确保 opcache.enable 全局开启。对于框架性应用，预编译缓存与自动加载路径的稳定性直接影响命中率。
对于常见框架如 Laravel、Symfony 等，尽量减少动态解析路径与运行时编译，以提升热代码命中率与整体吞吐量。
; Web 场景的建议配置片段
opcache.enable=1
opcache.revalidate_freq=2
opcache.validate_timestamps=1
4.2 CLI 场景的不同点
CLI 模式下，通常应关闭 opcache.enable_cli，或在部署脚本中按需开启，以避免为短暂 CLI 任务带来额外缓存开销。某些长期运行的 CLI 任务可考虑开启，以提升执行速度。
对于需要频繁执行的 CLI 任务，缓存的利弊需分辨，若缓存对执行时间影响有限，可尝试开启；若不确定，优先确保稳定性和可控性。
opcache.enable_cli=0
5. 常见坑与排错
5.1 缓存未命中率低的排错
若发现命中率偏低，首先检查 opcache.memory_consumption 是否充足、框架缓存配置是否合理，以及 自动加载路径是否存在频繁变动的脚本。缓存空间不足或命中率下降往往来自于这类因素。
另外，若使用 opcache.file_cache，请关注存储介质的性能与并发情况，网络存储（如 NFS）可能带来额外延迟，应评估改用本地缓存或分布式策略的可行性。
; 检查点
opcache.memory_consumption = 256
opcache.file_cache=/var/php-opcache
5.2 与框架/加载器集成的注意点
部分框架在热部署或代码热更时，缓存可能过于频繁失效，导致性能起伏。为避免频繁重建，需采用无停机更新的部署策略，并确保 OPcache 重建成本可控。
同时，确保 加载器（如 Composer 自动加载） 的路径被 OPcache 正确缓存，能减少重复加载时间，并提升整体响应速度。
