PHP OPcache 怎样区分预加载与脚本缓存

PHP OPcache 的脚本缓存保存编译后的字节码，让后续请求少做重复编译；预加载则在服务启动阶段载入一批定义，使其在后续请求中直接可用。两者不是互斥开关：启用 OPcache 不等于启用预加载，缓存命中也不能证明某个类已经预加载。

下面以 Linux PHP-FPM 为范围，关注只读发布目录、低权限执行和版本切换。PHP 官方预加载文档入口是 https://www.php.net/manual/en/opcache.preloading.php。示例是部署设计片段，不代表已在某台生产服务器执行或测得加速收益。

先按代码生命周期划清两种能力

先问“缓存什么”，再问“什么时候换掉”。普通脚本缓存保留编译结果，但应用仍按请求执行入口和加载逻辑；不要把缓存字节码理解为所有请求共享业务变量、登录会话或数据库连接。

预加载并不把任意全局变量或全局常量自动变成跨请求应用状态。它也不是 JIT 的同义词。PHP 手册注明此能力不支持 Windows，因此不能把本文配置直接当作 Windows 部署方案。

把预加载入口固定到只读发布目录

在 FPM 使用的系统级配置中明确开启 OPcache，并把入口绑定到一个不可变版本目录。下面的路径和账户都是示例，需要替换成实际部署值；假设 OPcache 扩展已安装并加载，不重复写扩展路径。

; FPM 所使用的系统级配置片段
opcache.enable=1
opcache.validate_timestamps=1
opcache.revalidate_freq=2
opcache.preload=/srv/catalog/releases/r42/preload.php
opcache.preload_user=app-preload

validate_timestamps=1 与 revalidate_freq=2 是普通脚本更新检测的配置示例，不会让已经预加载的定义每两秒自动换新。关闭时间戳检测之前，应先有确定的普通缓存更新策略；不要把它作为启用预加载的必要条件。

这里选版本目录而不是可变的 current 软链接，是为了让配置、预加载清单和发布版本能对应起来。只换软链接不能让旧进程中的预加载定义失效。核对时应看 FPM 实际配置来源，而不是仅凭命令行 php -i 的结果推断 Web 服务状态。

只预加载声明文件，不启动业务资源

从少量稳定、只有声明的类开始，使用显式白名单。不要递归纳入上传目录、测试文件、缓存生成文件或业务入口。下面用 opcache_compile_file() 编译两个独立类文件，失败时让启动过程明确报错，而不是悄悄运行一个缺失定义的实例。

该例假定两个文件只声明相互独立的类，不含需要执行才能建立的条件声明。若使用 require 或 include，被包含文件的顶层代码也会执行，且依赖的父类等必须按合适顺序加载。两种写法不能只按“哪个短”决定。

不要在预加载脚本中连接数据库、发送网络请求、启动会话、读取当前用户或做订单恢复。启动阶段没有正常请求上下文；把这些动作放进去，会让服务启动依赖外部系统，也不能得到可供所有请求安全复用的业务连接。

同一个文件在请求中再次被包含时，其内容仍可能执行；预加载不是“顶层副作用只发生一次”的保障。把声明文件和初始化脚本分开，能够让清单更容易理解和维护。

限制执行身份与诊断入口

opcache.preload_user 控制预加载的执行身份，不是给运行期业务提升权限。服务以 root 启动再降权时，应指定专用低权限账户；不应为了消除权限报错而改成 root。该账户只需读取清单涉及的代码，并能遍历父目录，不应拥有修改发布文件的权限。

发布账户负责写入新版本，运行账户只读，上传文件放在独立目录。对于互不信任的应用，应采用明确分离的进程实例或容器边界，不能仅凭 FPM pool 名不同就假定预加载定义已经完全隔离。

诊断也要有边界。只在受控内部诊断脚本中读取 OPcache 状态，记录 FPM 配置版本、发布编号、启动日志以及内存情况；不要向公网输出完整路径列表或开放无鉴权的缓存重置接口。缓存命中率很高，只能说明缓存复用情况，不能代替预加载成功的证据。

用进程换代完成发布和回滚

预加载的发布单位应是“代码、配置与新 PHP 进程”这一组。准备 r43 的完整目录和清单后，让新实例从 r43 配置启动；核对启动日志、版本标识和业务健康状态，再按现有部署平台的方式切换流量。此处是给运维人员的发布检查项，本文没有执行这些动作。

旧实例仍可能保留 r42 的定义。即使普通脚本已经读到新文件，也不能证明预加载部分同步更新。需要确保旧进程退出、工作进程全部换代，而不是把任意名为 reload 的命令都当成保证；具体服务管理方式以实际平台为准。

opcache_reset() 用于内存字节码缓存重置，不是清除预加载定义的替代方案，也不负责清理磁盘文件缓存。不要用一次返回 true 的重置调用，作为整个发布成功的判断。

回滚时同样启动绑定到旧版本目录的新进程，不能只换回入口软链接。发布记录至少保留代码版本、预加载清单、配置版本、启动结果和流量切换结果。如果无法承担进程换代和常驻内存成本，先只用普通 OPcache 也是合理选择；是否采用预加载，应结合真实应用数据判断，不能预设收益。

归纳起来，脚本缓存解决重复编译，预加载改变定义的准备时机和生命周期。把清单收窄、身份降权、代码只读和进程换代放进同一套发布流程，才能避免“文件已经更新，服务却仍在使用旧定义”的误判。

参考：PHP 预加载说明；OPcache 配置；opcache_reset 边界。