PHP7.4 升级 PHP8.2 之后，opcache 预加载功能怎么配置才能生效-php教程-PHP中文网

php 8.2 预加载需手动配置且仅限 fpm/mod_php，windows 不支持；必须启用 opcache、设绝对路径 preload.php、指定 opcache.preload_user（root 启动时）、用 opcache_compile_file() 安全预编译，并通过 opcache_get_status()['preload_statistics'] 验证生效。

php7.4 升级 php8.2 之后，opcache 预加载功能怎么配置才能生效

PHP 7.4 升级到 8.2 后，opcache 预加载（opcache.preload）不会自动生效——它需要手动配置、路径校验、用户权限适配，且 Windows 下完全不可用。

确认 PHP 8.2 环境已启用 OPcache 且支持预加载

预加载是 PHP 7.4 引入、PHP 8.x 持续演进的功能，但前提是 OPcache 必须在 FPM 进程中真正加载，而非仅 CLI 或 phpinfo() 页面里“看起来开了”：

php -m | grep opcache 成功 ≠ 预加载可用；必须访问 phpinfo() 页面，找到 Loaded Configuration File 路径，然后确认该 ini 文件里有 zend_extension=opcache.so（Linux/macOS）或带引号的绝对 DLL 路径（Windows），且重启的是 php-fpm 进程，不是 Apache/Nginx
调用 opcache_get_status() 必须返回数组，不能报 Call to undefined function opcache_get_status()
检查 php --ri opcache 输出中是否含 Preloading Support => enabled —— PHP 8.2 默认开启，但如果编译时加了 --disable-opcache-file 或用了某些精简版容器镜像，可能被关掉

写对 `preload.php` 并确保它被真实执行

预加载脚本不是“放那儿就行”，它会在 PHP-FPM master 进程启动时执行一次，任何 fatal error 都会导致 preload 失败且不报错（只静默跳过）：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

opcache.preload 必须指向绝对路径：opcache.preload=/var/www/app/preload.php，相对路径、符号链接、~ 展开全部无效
preload.php 文件权限需被 PHP-FPM worker 用户可读（如 www-data 或 nginx），且不能有语法错误——建议先用 php -l /var/www/app/preload.php 校验
推荐用 opcache_compile_file() 而非 require_once：前者只编译不执行，避免预加载时意外触发 DB 连接、日志写入等副作用；后者会执行代码，若含 if (ENV === 'prod') 类逻辑，反而导致类未注册
不要递归加载整个 vendor/：Composer 自动加载器本身已优化，盲目 preload vendor 会显著拖慢 FPM 启动，并可能因类重复定义报 Fatal error: Cannot declare class

处理 `opcache.preload_user` 权限问题

PHP 8.2 默认禁止 root 用户执行预加载，而多数 Linux 发行版的 php-fpm 默认以 root 启动 master 进程再 drop 权限——这会导致 preload 脚本运行失败：

如果 FPM master 以 root 启动，必须显式设置 opcache.preload_user=www-data（替换为你的 worker 用户名），否则 preload 直接被跳过
该用户必须对 preload.php 及其 require 或 opcache_compile_file() 的所有目标文件有读取权限
Windows 下该配置无效，且预加载功能本身不支持——升级到 PHP 8.2 后若还在 Windows 上跑，opcache.preload 字段会被忽略，无报错也无效果

验证预加载是否真生效

光看 phpinfo() 里的 “Preloaded Scripts” 区块不够，得看运行时行为：

访问 opcache_get_status()['preload_statistics']，检查 scripts 数量是否 > 0，memory_consumption 是否明显上升
故意在某个预加载类里加个 die('preloaded');，重启 php-fpm 后首次请求应立即终止并输出——若没触发，说明 preload.php 根本没跑
用 opcache_is_script_cached('/path/to/preloaded/file.php') 返回 true 才算成功缓存；注意该函数对未预加载但普通 OPcache 缓存的文件也返回 true，所以必须结合 preload_statistics 判断
上线后改了预加载的类，页面不更新？不是缓存没刷新，而是你忘了：预加载内容只能通过重启 php-fpm 清除，opcache_reset() 对它完全无效

最常被忽略的一点：预加载只在持久化进程模型下起作用（如 PHP-FPM、Apache mod_php），CLI 脚本每次都是新进程，preload 无意义；另外，Docker 容器若用 php -S 或 supervisord 直接跑 php-fpm 但没设好用户切换，opcache.preload_user 就成了摆设。