workerman需启用opcache.enable_cli=1、调高memory_consumption(≥256mb)和max_accelerated_files(≥20000)、关闭validate_timestamps=0,并配置preload预加载核心类,否则缓存命中率低或频繁oom重启。

Workerman 能直接从 OPcache 受益,但默认配置几乎肯定不够用——尤其在长连接、高频 reload 场景下,opcache.validate_timestamps=1 或内存不足会导致反复编译,反而拖慢响应。
确认 OPcache 已启用且对 CLI 生效
Workerman 是 CLI 进程,而 PHP 默认关闭 CLI 模式的 OPcache。只配了 opcache.enable=1 但没开 opcache.enable_cli=1,Workerman 就完全用不上缓存。
- 检查是否生效:运行
php -d opcache.enable_cli=1 -r "var_dump(opcache_get_status()['opcache_enabled']);",输出true才算真正启用 - 常见错误现象:Workerman 启动后
opcache_get_status()显示opcache_enabled => false,或命中率长期低于 50% - 不要只看
phpinfo()的 Web 环境结果——它和 CLI 完全是两套配置
必须调高的两个核心参数
opcache.memory_consumption 和 opcache.max_accelerated_files 是 Workerman 最容易卡住的两个点。框架本身文件多,加上 Composer 自动加载、业务类、协议解析器等,轻松突破默认值。
-
opcache.memory_consumption至少设为256(单位 MB),大项目建议512;低于128时缓存频繁淘汰,opcache_get_status()['memory_usage']['used_memory']接近上限就是信号 -
opcache.max_accelerated_files必须 ≥ 项目实际 PHP 文件数;用find /path/to/your/workerman/app -name "*.php" | wc -l估算,保守设为20000起步 - 别信“够用就行”——Workerman 进程常驻,缓存不淘汰才最省 CPU;
opcache.max_wasted_percentage默认 5,一般不用动
生产环境必须关掉时间戳校验
Workerman 不像 FPM 那样靠重启进程感知代码变更,opcache.validate_timestamps=1 会让每个请求都去磁盘 check mtime,IO 开销直接抵消缓存收益。
- 设
opcache.validate_timestamps=0,配合部署脚本调用opcache_reset()或kill -USR2通知 Workerman reload - 如果误设
opcache.revalidate_freq=0却没关validate_timestamps,等于白配——这个组合会强制每次请求都 stat 文件 - 开发阶段可临时设为
1+opcache.revalidate_freq=2,但上线前务必切回0
预加载(Preload)对 Workerman 很关键但易被忽略
Workerman 主进程启动时加载的类(如 Worker、Connection、自定义协议类)是高频使用的,预加载能避免首次连接时编译延迟。
- 写一个
preload.php,显式require_once核心类文件,路径必须绝对;不要 include 业务逻辑或配置文件 - 在 php.ini 中加
opcache.preload=/absolute/path/to/preload.php,并确保opcache.preload_user权限正确(通常 www-data 或 nobody) - 预加载失败不会报错,但
opcache_get_status()['preload_statistics']为空或failed_op_array非空就说明出问题了 - PHP 8.0+ 才支持,8.3 下还可配合
opcache.jit=1205进一步加速,但 JIT 对 Workerman 效果不稳定,建议先稳用 preloading
Workerman 的 OPcache 优化难点不在“启不启用”,而在“缓存能不能稳住、会不会误判、关键类有没有提前编译”。一旦 opcache_get_status() 显示 opcache_hit_rate 低于 95%,或 oom_restarts 非零,基本就是上面四点中某处没对齐。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











