opcache 是 php 的 opcode 缓存扩展，通过将编译后的 opcode 存入共享内存避免重复编译，使典型 web 请求 cpu 时间降低 20%–50%；需正确配置 memory_consumption、max_accelerated_files 等参数并手动管理缓存失效。
OPcache 是什么，为什么它能提速
PHP 是解释型语言，每次请求都要把 PHP 文件读取、词法分析、语法分析、编译成 opcode，再执行。这个编译过程重复发生，浪费 CPU 和时间。OPcache 的作用就是把编译后的 opcode 缓存到共享内存里，后续请求直接复用，跳过编译阶段。效果明显：典型 Web 请求的 CPU 时间可降 20%–50%，尤其对大量小文件或模板类项目提升显著。
- 不是所有代码都适合缓存：动态生成的 PHP 内容（如
eval()、create_function()）不会进 OPcache
- 缓存的是 opcode，不是执行结果；要缓存输出得用
ob_start() 或外部缓存如 Redis
- 启用后，修改 PHP 文件不会立即生效，需触发 OPcache 失效（比如调用
opcache_invalidate() 或重启 Web 服务）
如何确认 OPcache 已启用并正常工作
最直接的方式是查看 phpinfo() 页面，搜索 “OPcache” 区块；或者运行命令：
php -m | grep opcache
eval()、create_function()）不会进 OPcache ob_start() 或外部缓存如 Redis opcache_invalidate() 或重启 Web 服务）phpinfo() 页面，搜索 “OPcache” 区块；或者运行命令：
php -m | grep opcache
如果没输出，说明模块未加载。常见原因有：
-
opcache.so（Linux）或php_opcache.dll（Windows）未在php.ini中通过extension=加载 - PHP 是 CLI 模式运行，默认不启用 OPcache（需显式配置
opcache.enable_cli=1才生效） - 使用了非 ZTS 版本的 PHP 却加载了 ZTS 编译的 OPcache 扩展（报错类似
Invalid library (maybe not a PHP library)）
检查运行时状态可用：
<?php var_dump(opcache_get_status()); ?>
重点关注 opcache_get_status()['opcache_enabled'] 是否为 true，以及 memory_usage 中的 used_memory 是否随请求增长。
关键配置项怎么设才不翻车
OPcache 默认配置偏保守，生产环境必须调整。核心参数如下：
-
opcache.enable=1：必须开启，CLI 下还需配 opcache.enable_cli=1
-
opcache.memory_consumption=128：共享内存大小（MB），小项目 64 足够，中大型建议 128–256；设太小会导致频繁淘汰，命中率暴跌
-
opcache.max_accelerated_files=20000：能缓存的脚本数上限，Composer 项目常超默认的 2000，不够会报 Failed to prepare file for opcache
-
opcache.revalidate_freq=2：每 2 秒检查一次文件修改时间（单位：秒），设为 0 表示每次请求都校验（开发环境可用，生产务必改大）
-
opcache.validate_timestamps=1：决定是否检查文件时间戳，上线后应设为 0 并配合 opcache_invalidate() 或 opcache_reset() 手动刷新
opcache.enable=1：必须开启，CLI 下还需配 opcache.enable_cli=1 opcache.memory_consumption=128：共享内存大小（MB），小项目 64 足够，中大型建议 128–256；设太小会导致频繁淘汰，命中率暴跌 opcache.max_accelerated_files=20000：能缓存的脚本数上限，Composer 项目常超默认的 2000，不够会报 Failed to prepare file for opcache opcache.revalidate_freq=2：每 2 秒检查一次文件修改时间（单位：秒），设为 0 表示每次请求都校验（开发环境可用，生产务必改大） opcache.validate_timestamps=1：决定是否检查文件时间戳，上线后应设为 0 并配合 opcache_invalidate() 或 opcache_reset() 手动刷新 注意：opcache.validate_timestamps=0 时，改完代码必须主动重置缓存，否则永远看不到新逻辑。
立即学习“PHP免费学习笔记（深入）”；
缓存失效和调试的实操要点
OPcache 没有自动“热更新”，靠时间戳或手动干预。线上发布后最常遇到的问题是“代码改了但没生效”，本质是缓存没清。
- 清单式刷新单个文件：
opcache_invalidate('/path/to/script.php', true)（第二个参数 true 强制重编译）
- 全局重置（慎用）：
opcache_reset()，会清空全部缓存，可能引发短暂性能抖动
- 配合部署脚本，在 rsync/cp 后自动执行
curl -X POST <a href="https://www.php.cn/link/f1f901606f26ef6fa343937bd99c23b7">https://www.php.cn/link/f1f901606f26ef6fa343937bd99c23b7</a>（该脚本仅限内网且带简单鉴权）
opcache_invalidate('/path/to/script.php', true)（第二个参数 true 强制重编译） opcache_reset()，会清空全部缓存，可能引发短暂性能抖动 curl -X POST <a href="https://www.php.cn/link/f1f901606f26ef6fa343937bd99c23b7">https://www.php.cn/link/f1f901606f26ef6fa343937bd99c23b7</a>（该脚本仅限内网且带简单鉴权） 调试时容易忽略的一点：OPcache 对 include/require 的路径解析依赖当前工作目录（getcwd()），符号链接、chdir() 后的包含行为可能意外绕过缓存。建议统一用绝对路径包含，或确保 opcache.use_cwd=1（默认开启，但某些容器环境会被覆盖）。
