Linux服务器启用PHP OPcache能改善哪些性能?如何验证缓存是否生效

发布人:A5数据发布时间:2026-10-30 11:54阅读量:115

PHP代码已经放进了内存,并不代表每次请求都能直接复用编译结果;反过来,启用OPcache后页面也不会自动变成“整页缓存”。OPcache主要缓存PHP脚本编译后的字节码,减少词法解析、语法编译和部分优化工作,因此通常改善的是PHP应用的CPU占用、请求处理时间和单位时间吞吐量。

验证是否生效,不能只在命令行执行php -i后看到opcache.enable => On就下结论。命令行PHP和网站使用的PHP-FPM可能不是同一个SAPI、配置文件甚至PHP版本。更可靠的做法是:先确认实际Web请求使用的运行环境,再读取该环境的OPcache状态,最后结合重复请求、上游响应时间和CPU变化进行验证。

先界定OPcache缓存的对象

一次动态PHP请求通常会经过以下环节:

  1. 客户端建立连接,经过Nginx或Apache。
  2. Web服务器将请求转发给PHP-FPM或其他PHP运行环境。
  3. PHP加载脚本、解析语法并编译为字节码。
  4. 执行PHP逻辑,访问数据库、文件系统或其他上游服务。
  5. 返回HTML、JSON或其他响应内容。
  6. Web服务器执行压缩、连接复用和响应传输。

OPcache主要作用在第3步。第一次访问某个PHP文件时,PHP需要读取源代码并完成编译;编译结果可以放入OPcache的共享内存。后续PHP-FPM工作进程再次执行该文件时,可以直接取得字节码,减少重复编译。

先界定OPcache缓存的对象配图

它缓存的是“代码的编译结果”,不是以下内容:

  • 不是整页HTML缓存;
  • 不是数据库查询结果缓存;
  • 不是Redis或Memcached;
  • 不是图片、CSS、JavaScript等静态资源缓存;
  • 不是浏览器缓存或CDN缓存;
  • 不是PHP脚本执行后的变量和返回结果。

例如,一个PHP页面每次都执行数据库查询,即使OPcache已命中,数据库查询仍然会发生。OPcache只能减少PHP准备和编译代码的成本,不能替代数据库索引、查询缓存或应用层缓存。

它通常改善哪些指标

在PHP代码量较大、请求量较高、PHP执行占用明显的站点中,OPcache可能带来以下变化:

  • PHP进程CPU占用下降;
  • 单个请求的PHP执行时间缩短;
  • PHP-FPM工作进程更快释放;
  • 在相同pm.max_children配置下,能够处理更多请求;
  • 高并发时,PHP-FPM排队时间可能减少;
  • 首字节时间和整体响应时间可能改善。

收益大小取决于PHP执行时间在整个请求链路中的占比。如果一个请求总耗时300毫秒,其中250毫秒在等待数据库,PHP编译只占几毫秒,那么启用OPcache后整体延迟不会按比例下降。

A5idc数据面向PHP网站、业务后台和接口服务,提供香港、美国、日本、新加坡等地区的物理服务器资源,覆盖Xeon Gold、AMD EPYC平台及SSD、NVMe存储,并配套不同带宽线路。对于需要运行PHP-FPM、数据库与多任务进程的Linux业务,可依托多核处理器、内存和高速磁盘,为OPcache之外的计算、磁盘与网络环节提供相应的部署基础。

PHP-FPM如何复用OPcache

PHP-FPM通常会启动多个工作进程。OPcache会将编译后的脚本放在共享内存中,使同一PHP运行环境下的多个工作进程能够复用缓存,而不必每个进程都重新编译相同文件。

需要注意以下几个边界:

  • 不同PHP主版本通常使用不同的运行环境和缓存;
  • 不同容器或不同PHP-FPM主进程之间不会自动共享缓存;
  • 命令行PHP和PHP-FPM可能使用不同的php.ini;
  • opcache.enable_cli只影响命令行SAPI,不代表网站SAPI;
  • PHP-FPM重启或重新加载后,缓存通常会经历冷启动;
  • 新发布的PHP文件需要按照时间戳检查或部署流程重新验证。

因此,命令行中看到OPcache开启,只能说明CLI环境已开启。网站是否启用,仍应通过实际HTTP请求对应的PHP脚本进行确认。

首次请求不一定代表最终效果

在PHP-FPM刚启动、缓存刚被清空或刚发布新版本时,首次请求可能需要完成编译,之后请求才进入稳定状态。验证时应区分:

  • 冷缓存请求:可能包含加载和编译成本;
  • 热缓存请求:主要体现字节码复用效果;
  • 部署后的短暂阶段:缓存逐步填充,命中率会逐渐上升。

如果站点流量较低,num_cached_scripts暂时较小并不一定是故障,可能只是实际访问到的PHP文件还不多。

配置时要关注哪些参数

不同发行版的配置文件路径可能不同。常见位置包括PHP配置目录下的conf.d或PHP-FPM专用配置目录,但不应直接假定路径。可以先查看CLI配置:

php --ini
php -v
php -i | grep -E 'Loaded Configuration File|Scan this dir for additional .ini files|opcache'

这组命令只用于了解CLI环境。实际网站配置还需要通过PHP-FPM对应的Web请求确认。

一个适合作为起点的配置示例如下:

[opcache]
opcache.enable=1
opcache.enable_cli=0
opcache.memory_consumption=128
opcache.interned_strings_buffer=16
opcache.max_accelerated_files=20000
opcache.validate_timestamps=1
opcache.revalidate_freq=2
opcache.max_wasted_percentage=5
opcache.save_comments=1

这些数值不是所有服务器都适用,重点在于理解参数之间的关系。

参数作用判断重点
opcache.enable是否为当前SAPI启用OPcache网站请求对应的PHP-FPM必须为开启状态
opcache.enable_cli是否为CLI启用OPcache不影响PHP-FPM网站请求
opcache.memory_consumptionOPcache共享内存大小,通常按MB配置代码量大时需要观察剩余内存
opcache.interned_strings_buffer保存重复字符串的共享空间框架和依赖较多时可适当增加
opcache.max_accelerated_files可缓存的脚本数量上限应覆盖实际PHP文件规模
opcache.validate_timestamps是否检查源文件时间变化决定代码发布后是否自动发现变更
opcache.revalidate_freq时间戳检查间隔,单位为秒影响开发便利性和文件检查开销
opcache.max_wasted_percentage碎片化空间达到一定比例时触发处理结合状态中的wasted_memory观察
opcache.save_comments是否保留PHP注释使用注解、反射或依赖注释的框架不宜关闭

开发环境与生产环境的取舍

开发环境一般保留:

opcache.validate_timestamps=1
opcache.revalidate_freq=0

这样每次请求都会更及时地检查源文件变化,但文件检查开销会增加。

生产环境可以根据发布方式选择:

opcache.validate_timestamps=1
opcache.revalidate_freq=2

或者在发布流程可控、每次发布都会平滑重载PHP-FPM时使用:

opcache.validate_timestamps=0

关闭时间戳检查后,PHP不会自动发现已经替换的源文件。若发布后不重载或不清理缓存,旧字节码可能继续运行,造成代码版本不一致。因此,生产环境关闭检查并不是简单的性能开关,而是对发布流程的要求。

修改配置前应备份原文件,并优先在测试环境验证。生产环境变更时,需要先确认PHP-FPM服务名称和配置检查命令;不同发行版可能使用php-fpm、php8.2-fpm等不同名称。确认配置无误后再平滑重载。若新配置异常,应恢复备份文件并重新加载原配置。

如何确认实际网站已经启用

第一步:确认Web请求使用的SAPI

可以临时建立一个仅限内网或管理员访问的PHP信息页面:

<?php
header('Content-Type: text/plain; charset=utf-8');

echo 'PHP_VERSION=' . PHP_VERSION . PHP_EOL;
echo 'PHP_SAPI=' . PHP_SAPI . PHP_EOL;
echo 'PHP_INI=' . (php_ini_loaded_file() ?: 'none') . PHP_EOL;
echo 'OPCACHE_FUNCTION=' . (function_exists('opcache_get_status') ? 'yes' : 'no') . PHP_EOL;
echo 'OPCACHE_ENABLE=' . ini_get('opcache.enable') . PHP_EOL;

通过浏览器或curl访问这个页面,确认:

  • PHP_SAPI通常应为fpm-fcgi或站点实际使用的SAPI;
  • PHP_INI是Web请求加载的配置文件;
  • OPCACHE_FUNCTION为yes;
  • OPCACHE_ENABLE为1。

测试完成后应删除该文件,或者在Web服务器层增加访问控制。PHP信息页面可能暴露版本、扩展和路径信息,不适合长期公开。

第二步:读取OPcache运行状态

可以使用下面的临时状态脚本:

<?php
header('Content-Type: application/json; charset=utf-8');

$result = [
    'php_version' => PHP_VERSION,
    'sapi' => PHP_SAPI,
    'opcache_function_exists' => function_exists('opcache_get_status'),
];

if (!function_exists('opcache_get_status')) {
    echo json_encode($result, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
    exit;
}

$status = opcache_get_status(false);

if ($status === false) {
    $result['enabled'] = false;
    $result['message'] = 'OPcache未启用,或当前SAPI无法读取状态';
} else {
    $statistics = $status['opcache_statistics'] ?? [];
    $memory = $status['memory_usage'] ?? [];

    $result['enabled'] = true;
    $result['statistics'] = [
        'num_cached_scripts' => $statistics['num_cached_scripts'] ?? null,
        'hits' => $statistics['hits'] ?? null,
        'misses' => $statistics['misses'] ?? null,
        'hit_rate' => $statistics['opcache_hit_rate'] ?? null,
    ];
    $result['memory_usage'] = [
        'used_memory' => $memory['used_memory'] ?? null,
        'free_memory' => $memory['free_memory'] ?? null,
        'wasted_memory' => $memory['wasted_memory'] ?? null,
    ];
}

echo json_encode($result, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);

这里使用opcache_get_status(false),避免返回脚本列表。示例输出可以类似:

{
    "php_version": "8.2.x",
    "sapi": "fpm-fcgi",
    "opcache_function_exists": true,
    "enabled": true,
    "statistics": {
        "num_cached_scripts": 8420,
        "hits": 1280000,
        "misses": 8900,
        "hit_rate": 99.3
    },
    "memory_usage": {
        "used_memory": 81788928,
        "free_memory": 52510720,
        "wasted_memory": 1048576
    }
}

以上数值只是演示读取方式,不代表固定结果。判断时应关注趋势和比例:

  • enabled=true说明当前请求可以使用OPcache;
  • num_cached_scripts反映已经进入缓存的脚本数量;
  • hits在重复访问后应持续增加;
  • misses在首次加载新脚本、缓存重启或缓存未命中时增加;
  • hit_rate较高通常是积极信号,但不能脱离请求量单独判断;
  • free_memory长期很低、wasted_memory持续升高时,需要评估内存和缓存碎片。

如果状态接口显示启用,但num_cached_scripts始终为零,常见原因包括访问的并非动态PHP页面、状态脚本没有经过预期的PHP-FPM、缓存刚刚重置,或者实际业务使用了另一套PHP运行环境。

第三步:用连续请求观察命中变化

先访问状态接口记录一次hits和misses,然后访问一个确定会执行PHP代码的动态页面两次或多次,再读取状态。

for i in $(seq 1 5); do
    curl -sS -o /dev/null \
      -w "request=$i starttransfer=%{time_starttransfer}s total=%{time_total}s\n" \
      http://127.0.0.1/test.php
done

如果站点依赖特定Host,可以补充请求头:

curl -sS -o /dev/null \
  -H 'Host: example.com' \
  -w 'starttransfer=%{time_starttransfer}s total=%{time_total}s\n' \
  http://127.0.0.1/test.php

重新查看OPcache状态时,通常可以看到:

  • hits增加;
  • 首次访问可能增加misses;
  • num_cached_scripts可能增加;
  • 后续访问相同代码时,不应每次都产生新的编译未命中。

不能要求每一次请求都让hits增加一个固定数值,因为一次页面请求可能包含多个PHP文件,也可能命中框架缓存、页面缓存或不同的代码路径。更有意义的是在相同流量下比较一段时间内的变化。

如何确认实际网站已经启用配图

第四步:确认改善的是PHP上游,而不是其他缓存

curl的时间数据可以辅助判断链路:

curl -sS -o /dev/null \
  -w 'dns=%{time_namelookup}s connect=%{time_connect}s starttransfer=%{time_starttransfer}s total=%{time_total}s\n' \
  https://example.com/dynamic.php

如果使用Nginx反向代理或FastCGI,还可以检查访问日志中是否记录了以下指标:

  • $request_time:整个请求耗时;
  • $upstream_connect_time:连接上游耗时;
  • $upstream_header_time:收到上游响应头耗时;
  • $upstream_response_time:上游响应耗时。

OPcache更可能影响上游PHP的处理时间和响应头返回时间,而不会直接降低DNS、TCP连接、静态文件传输或客户端网络耗时。

如果动态页面经过CDN或整页缓存,重复请求可能根本没有到达PHP-FPM。验证时应使用内部地址、专用动态测试页面或确认响应确实回源,避免把CDN命中误判成OPcache生效。

只看命中率还不够

性能验证应同时观察业务请求和主机资源。一个用于说明判断逻辑的示例对比如下:

只看命中率还不够配图

状态PHP-FPM CPU占用动态请求P95PHP-FPM排队解释
未启用或缓存频繁失效约78%约180ms偶发编译和执行成本较高
缓存稳定命中约48%约110ms明显减少PHP处理阶段缩短
数据库成为瓶颈约35%约175ms较少OPcache有效,但主要耗时不在编译

这些是演示验证方法的示例数据,不是固定性能承诺。实际对比时应保持以下条件尽量一致:

  • 使用同一版本的PHP和业务代码;
  • 使用同一PHP-FPM进程数和机器资源;
  • 保持数据库、外部接口和网络条件稳定;
  • 先进行预热,再采集正式数据;
  • 使用相同并发数和相同请求路径;
  • 至少重复多轮,避免只比较一次请求;
  • 同时记录P50、P95或P99,而不是只看平均值。

如果启用OPcache后命中率很高,但P95响应时间几乎不变,应继续检查数据库、外部HTTP请求、磁盘IO、PHP-FPM队列和锁等待。反过来,如果CPU下降、上游响应时间缩短,但客户端总耗时不变,问题可能位于网络、压缩、静态资源或客户端链路。

哪些参数和组件不要混为一谈

OPcache只负责PHP代码编译结果,以下优化属于其他层面:

  • Nginx或Apache的Keep-Alive影响连接复用;
  • Gzip或Brotli影响响应体传输大小;
  • 静态资源缓存影响图片、脚本和样式文件的重复传输;
  • 数据库索引和查询缓存影响数据访问时间;
  • Redis等应用缓存影响业务数据读取;
  • fastcgi_connect_timeout影响连接上游时最多等待多久;
  • fastcgi_read_timeout影响等待上游响应的超时边界;
  • pm.max_children影响PHP-FPM并发处理能力。

提高fastcgi_read_timeout不会让PHP执行更快,只会允许请求等待更久,甚至可能掩盖上游变慢。OPcache如果减少了PHP处理时间,可能间接降低上游连接占用,但它不能代替合理的超时、进程数和数据库配置。

PHP 8中的JIT也不等同于普通OPcache。OPcache的字节码缓存通常对传统Web应用更直接;JIT主要针对特定类型的CPU密集型计算,普通业务如果主要等待数据库或网络,启用JIT不一定带来明显收益,应单独基准测试。

容易导致缓存失效或效果不明显的情况

缓存空间不足

当PHP文件数量较多或框架依赖复杂时,max_accelerated_files过小会导致部分脚本无法稳定缓存。memory_consumption过小则可能频繁重启缓存或产生较多浪费空间。

不要仅凭服务器总内存决定该值。还要为PHP-FPM进程、数据库、系统缓存和其他服务预留内存。容器环境还需要考虑容器内存限制。

发布后仍运行旧代码

opcache.validate_timestamps=0时,直接替换PHP文件不代表工作进程立即使用新代码。生产发布应配合平滑重载、版本目录切换和明确的缓存更新流程。发布后应通过版本标识、响应头或状态接口确认请求已经进入新版本。

CLI与FPM配置不一致

下面的命令可能显示CLI已经开启:

php -r 'var_dump(PHP_SAPI, ini_get("opcache.enable"), function_exists("opcache_get_status"));'

但网站仍可能使用另一套PHP-FPM配置。遇到这种情况,应以实际HTTP访问结果为准,而不是继续修改CLI的php.ini。

请求本身不适合观察

静态HTML、图片或已经被Nginx缓存的响应,不会体现PHP的OPcache效果。测试页面应确保确实经过PHP-FPM,并且执行路径包含目标PHP文件。

PHP执行只是总耗时的一小部分

如果应用请求主要等待数据库、远程接口、消息队列或磁盘,那么OPcache只能优化其中一段。此时应结合应用日志和上游耗时指标定位,不宜为了追求更高命中率而盲目增加共享内存。

判断OPcache是否真正生效,可以采用一个明确的标准:实际Web SAPI显示已启用,重复访问动态PHP路径后hits持续增加,缓存脚本数量和内存使用处于合理范围,同时PHP上游响应时间或CPU占用在可控对比中出现改善。若只有配置项显示开启,却没有命中变化或整体请求变快,应优先确认请求是否经过正确的PHP-FPM、缓存是否频繁重置,以及真正的瓶颈是否位于数据库、网络或其他上游服务。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/6597.html

相关推荐