为了压首字节时间,给一台 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。收益不算大,但启动不再炸,这份清单也进了发布流程,改类名要同步更新。
