PHP 8.3 开 opcache.preload 后启动直接报错 类重复声明怎么排

为了压首字节时间,给一台 PHP 8.3.13 的机器开了 opcache.preload,脚本里 require 了三十多个核心类。reload 之后 FPM 起不来,error log 里只有一行 Cannot declare class App\Service\OrderService, because the name is already in use。

第一反应是 preload 脚本里重复 require 了同一个文件。翻脚本,用的是 require_once,同一路径不会重复。再看报错位置,指向的是另一个类文件,跟被声明两次的类不在一个文件里。

盯了一会儿才想明白。preload 阶段 require 一个类文件时,文件里如果继承了别的类,composer 的 autoloader 会介入,把父类加载进来;等脚本执行到父类的 require_once,opcache 在 preload 上下文里仍然会再编译一次,判定重复声明。根因是 autoload 和显式 require 两条路径混着走。

试过把脚本改成只 require autoload.php,再逐个 class_exists 触发加载。这样能起来,但类只是加载进进程,没进 opcache 的共享内存,preload 的收益基本为零,第一天命中率只涨了 0.4%。

换成 opcache_compile_file,只编译不执行,既不触发 autoload,也不会产生重复声明。

// 只编译不执行
$list = require __DIR__ . '/preload_list.php';
foreach ($list as $f) {
    if (!opcache_compile_file($f)) {
        error_log('preload fail ' . $f);
    }
}
; php.ini
opcache.preload=/data/www/preload.php
opcache.preload_user=www-data

启动期还有一个坑,preload_user 没写的时候 FPM 以 root 跑,直接拒绝加载,日志只有一句 preloading failed,不指位置。补上 www-data 之后 php-fpm -t 才过。

验证不看日志看计数。opcache_get_status 里的 preload_statistics 显示 scripts 是 312,跟清单条数一致;再压五百次请求,首字节 P50 从 21ms 降到 17ms。收益不算大,但启动不再炸,这份清单也进了发布流程,改类名要同步更新。

您可以还会对下面的文章感兴趣: