服务器上的PHP OPcache容量,应根据哪些指标调整?
OPcache 容量不应按 PHP-FPM 并发数直接换算。它主要取决于需要缓存的 PHP 脚本及其字节码、缓存键数量、内部化字符串占用,以及代码发布和更新造成的缓存变化;并发和请求量则通过扩大活跃代码范围、增加 PHP worker 的内存需求等方式间接影响规划。调整时应把 OPcache 共享缓存与 PHP-FPM worker 的进程内存分开评估。
先画出负载画像
请求量高不一定意味着 OPcache 必须更大:如果请求集中在一组稳定的脚本上,缓存工作集可能并不大;请求量较低的多租户应用,如果每个租户都会加载不同的脚本,也可能积累大量缓存项。因此,规划前先确认业务在峰值时实际会触达哪些代码。
重点记录以下信息:
- 并发与 worker 数量:PHP-FPM 的
pm.max_children等设置影响同时执行请求的进程数量。它们会影响主机总内存和处理能力,但不会让同一份已缓存脚本按 worker 数量复制多份。 - 请求类型与代码覆盖范围:首页、API、后台任务、定时任务和低频管理功能可能加载不同脚本。只用常见页面预热,容易漏掉低频但重要的代码路径。
- 代码规模与文件组织:框架、依赖库、插件、租户定制代码、动态生成的 PHP 文件,都会影响被缓存的脚本数量和占用。
- 峰值与业务变化:促销、批处理、上线新功能、租户增加等变化,可能使平时未触达的代码集中进入缓存。
- 运行实例数量:每个独立 PHP 运行环境都要单独评估。不同容器或不同 PHP-FPM 主实例通常各有自己的缓存;不能将一个实例的容量当成所有实例共享的总容量。
并发更适合用于评估 FPM worker 和主机整体内存。若需要估算 worker 内存,可在代表性高峰期间观察进程的实际内存占用,再结合 worker 数量和其他服务的预算;不要把单个 worker 的请求内存直接算进 opcache.memory_consumption。

将资源变量对应到 OPcache 参数
OPcache 的几个容量设置解决的是不同问题,不宜只调一个参数来处理所有缓存告警。
| 资源变量或指标 | 主要对应设置或状态 | 应如何判断 |
|---|---|---|
| 缓存字节码的共享内存 | opcache.memory_consumption、memory_usage | 看已用、空闲和废弃内存,以及峰值期间是否持续接近满载 |
| 缓存键数量 | opcache.max_accelerated_files、num_cached_keys、max_cached_keys | 看当前键数量是否长期逼近上限;键数不足不等于共享内存不足 |
| 内部化字符串 | opcache.interned_strings_buffer、interned_strings_usage | 单独观察已用和空闲量,避免只看共享内存指标 |
| 代码更新和缓存失效 | wasted_memory、废弃比例、重启计数 | 判断是否是频繁发布、文件变化或缓存重建造成空间压力 |
| PHP 请求进程 | FPM worker 数量及其实际内存占用 | 在主机内存层面评估,不要按 worker 数量重复计算 OPcache |
opcache.memory_consumption 控制共享缓存空间。OPcache 状态中的 used_memory、free_memory 和 wasted_memory 应放在一起看:废弃内存虽然不再承载有效缓存内容,但在被回收前仍会占据缓存空间。只看已用内存,可能低估实际压力。
opcache.max_accelerated_files 关系到可缓存文件对应的键数量。若当前键数接近上限,即使共享内存还有余量,也可能需要提高这个上限。反过来,如果键数充足但共享内存反复不足,单独扩大键数量不会解决问题。不同 PHP 版本对可用键数量的具体处理可能有所区别,应以运行环境的配置和状态为准。
opcache.interned_strings_buffer 是另一个需要独立监控的维度。框架、依赖和代码中大量重复字符串可能使其占用增长。若字符串缓冲区接近满载而共享内存仍有余量,应优先检查该项,而不是把所有容量问题都归结为 opcache.memory_consumption。
用运行状态判断瓶颈
容量规划应基于与生产运行方式一致的 PHP SAPI。命令行 PHP 和 PHP-FPM 的配置可能不同;在命令行查看到的值,未必代表 FPM 正在使用的值。可以在受限的内部诊断入口中读取 FPM 的 OPcache 状态,注意不要把包含脚本路径的详细结果公开到互联网。
例如,以下代码只读取概要状态,不输出每个脚本的路径:
<?php
$status = opcache_get_status(false);
if ($status === false) {
http_response_code(503);
exit('OPcache status unavailable');
}
$memory = $status['memory_usage'] ?? [];
$strings = $status['interned_strings_usage'] ?? [];
$stats = $status['opcache_statistics'] ?? [];
$result = [
'enabled' => $status['opcache_enabled'] ?? null,
'cache_full' => $status['cache_full'] ?? null,
'restart_pending' => $status['restart_pending'] ?? null,
'restart_in_progress' => $status['restart_in_progress'] ?? null,
'memory_usage' => $memory,
'interned_strings_usage' => $strings,
'num_cached_scripts' => $stats['num_cached_scripts'] ?? null,
'num_cached_keys' => $stats['num_cached_keys'] ?? null,
'max_cached_keys' => $stats['max_cached_keys'] ?? null,
'oom_restarts' => $stats['oom_restarts'] ?? null,
'hash_restarts' => $stats['hash_restarts'] ?? null,
'manual_restarts' => $stats['manual_restarts'] ?? null,
];
header('Content-Type: application/json');
echo json_encode($result, JSON_PRETTY_PRINT);
诊断入口应限制访问,并在诊断完成后移除或继续保持内网访问控制。采集时尽量覆盖流量高峰、定时任务和发布后的缓存预热阶段;一次启动后刚开始运行的数据,不足以代表稳定工作集。
判断时可按现象区分:

- 空闲共享内存持续偏低,且出现内存不足相关重启:优先评估扩大
opcache.memory_consumption,同时确认缓存废弃是否由频繁更新造成。 - 键数量接近上限,但共享内存仍宽裕:评估提高
opcache.max_accelerated_files,并检查是否有大量动态脚本或重复路径。 - 内部化字符串空闲量持续偏低:单独评估
opcache.interned_strings_buffer,并观察其变化是否与代码集增长一致。 - 废弃内存增长明显,伴随频繁重启或缓存重建:先分析代码发布、文件失效和缓存更新方式。单纯扩大共享内存可能推迟问题出现,却不一定消除反复重建。
- OPcache 指标正常,但 PHP-FPM 排队或主机内存紧张:应转向检查 worker 数量、请求耗时和单请求内存等因素。扩大 OPcache 不能代替 FPM 或主机资源规划。
oom_restarts、hash_restarts 等计数应观察一段时间内的增量,而不是只看进程启动以来的累计数。发生一次重启也需要结合发布和运行时间判断;若计数在正常高峰期间反复增加,才更能说明容量或缓存稳定性存在问题。
估算容量并预留余量
可先用状态数据建立一个估算:
所需共享缓存空间 ≈ 高峰有效占用 + 高峰废弃占用 + 预计代码增长 + 运维余量
其中,“预计代码增长”应来自计划上线的功能、依赖升级、租户增长或其他明确的工作集变化;“运维余量”则用于吸收峰值波动和估算误差。不要用请求量增长百分比,直接等比例推导 OPcache 内存增长:请求量翻倍,并不必然意味着代码缓存需求翻倍。
举例来说,某实例在代表性高峰观察到有效占用约 76 MiB、废弃占用约 6 MiB;按未来代码工作集可能增加约 15 MiB 估算,再为波动预留约 20% 的余量,所需空间约为:
(76 + 6 + 15) ÷ (1 - 20%) ≈ 121 MiB
在该假设下,可以把 128 MiB 作为下一档测试值,再复测高峰使用情况。这个估算只说明如何计算,不代表特定服务器可承载的业务量;实际结果还取决于代码集、PHP 版本、发布方式和运行实例配置。若预期增长较快,应明确余量覆盖的周期,并在每次主要版本或依赖变化后重新评估。
键数量和内部化字符串也要分别留出空间。可以将当前峰值键数量与配置上限比较,并给新增功能、低频路径和租户增长预留一定比例;例如以约 20% 的键数量余量作为初始规划值,再由实际运行数据校正。这个比例不是固定标准,若代码工作集变化快,应使用更大的余量或缩短复核周期。
部署方式同样会影响缓存稳定性。频繁替换文件、使用大量不同路径的动态脚本,可能增加废弃项或缓存键数量。生产环境若关闭时间戳校验,需要配套明确的发布与缓存刷新机制,否则可能存在旧代码继续服务的风险。不要把周期性清空缓存当作常规容量方案:清空后重新预热会增加冷缓存阶段的负担,且可能让问题暂时隐藏。
确定监控与扩容触发点
扩容阈值应根据业务高峰和发布周期确定,而不是只设一个固定的“达到多少就加内存”。先连续采集覆盖正常峰值、批处理和发布的样本,再根据趋势设置预警与扩容条件。可将以下条件作为初始观察点,之后按实际数据调整:
- 高峰期间共享缓存空闲量持续低于总量的约 10%–15%,而不是仅在短暂启动阶段出现;
oom_restarts或相关缓存重启计数在连续采样周期内增加;num_cached_keys长期接近max_cached_keys,并且工作集仍在增长;- 内部化字符串空闲量反复接近耗尽;
- 废弃内存不断累积,或发布后频繁出现缓存重建,影响服务的稳定性。
每次变更后,应在相同业务路径和相近负载下复测,并同时检查 FPM 进程与整机内存。若调整共享缓存后,OPcache 告警消失但主机内存余量明显下降,就需要重新核算所有独立缓存实例、PHP worker 和其他服务的总预算。最终的扩容触发点,应由“峰值使用趋势、重启事件、键数量余量、代码增长计划和主机剩余内存”共同确定。
PHP 应用的容量规划离不开服务器内存与整体运行资源。A5idc数据提供香港、美国、日本等地区的物理服务器,涵盖 Xeon Gold、AMD EPYC 等平台及 SSD、NVMe 存储,并有不同内存配置,可为网站、业务后台和数据库等负载提供服务器资源基础;多地区与线路方案也覆盖面向不同用户区域的部署需求。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/9715.html

