Composer自动加载器不能直接预加载，因其vendor/autoload.php含运行时逻辑；正确做法是生成classmap后在preload.php中静态require类文件。
Composer 本身不直接参与 PHP 预加载，但它的自动加载机制与 opcache.preload 的配置方式存在关键冲突点——预加载必须在 OPcache 启动时完成，而 Composer 的 vendor/autoload.php 是运行时动态构建的，不能直接 preload。
为什么不能直接 include vendor/autoload.php 到 preload 脚本中
因为 vendor/autoload.php 内部会执行大量运行时逻辑：检测环境、注册 autoloader、读取 composer.json、生成 class map（如果启用）、甚至触发插件钩子。这些操作在 OPcache preload 阶段是禁止的（会报 Fatal error: Cannot use 'require' in preloaded files 或更隐蔽的 Class not found）。
- preload 脚本必须只包含
class、interface、trait、function和const声明，不能有函数调用、require/include、变量赋值等运行时行为 - Composer 的 autoload 文件本质是一个“启动器”，不是纯声明文件
- 即使你强行把
vendor/autoload.php加入opcache.preload，PHP 会在启动时报错并跳过整个 preload 过程
正确做法：生成静态 preload 脚本 + 手动包含核心类文件
你需要绕过 Composer 的自动加载器，用静态方式列出所有希望预加载的类文件，并确保它们不依赖未 preload 的代码。推荐流程如下：
- 使用
composer dump-autoload --optimize-autoloader --classmap-authoritative生成权威 classmap（vendor/composer/autoload_classmap.php），它是一个纯return [...]数组，不含运行时逻辑 - 编写自定义 preload 脚本（如
preload.php），遍历该 classmap，对每个类文件执行require_once—— 注意：仅限于 PHP 8.0+，且需确保这些文件本身也不含运行时副作用 - 在
php.ini中设置：opcache.preload=/path/to/preload.php
foreach (include 'vendor/composer/autoload_classmap.php' as $class => $file) {
if (file_exists($file)) {
require_once $file;
}
}
哪些类适合放进 preload？哪些要排除？
不是所有类都适合预加载。盲目 preload 大量类反而可能增加内存占用、延长 PHP 启动时间，甚至因依赖顺序错误导致失败。
立即学习“PHP免费学习笔记（深入）”；
-
推荐 preload：框架核心类（如 Laravel 的
Illuminate\Container\Container）、高频使用的工具类（Carbon\Carbon、Monolog\Logger）、无构造副作用的 DTO/ValueObject -
必须排除：含
__construct()副作用的类（比如连接数据库、读配置文件）、依赖未 preload 类的类、使用class_alias()或动态 define 的类、含static::早期绑定或 trait 冲突的类 - 可通过
composer show --tree梳理依赖图谱，优先选“叶子节点”类（即不依赖其他业务类的类）
验证是否生效及常见失败信号
预加载是否成功不能只看 PHP 启动不报错，要实际验证：
- 检查 OPcache 状态：
opcache_get_status()['preload_statistics']应显示scripts数量和memory_consumption - 用
opcache_is_script_cached('/path/to/SomeClass.php')确认具体文件已缓存 - 典型失败现象：
Class XXX not found（依赖未 preload）、Cannot declare class YYY, because the name is already in use（重复 require）、Failed to preload ... due to compilation error（脚本里写了非法语句） - 调试技巧：在 preload 脚本开头加
error_log("preload start");，配合tail -f /var/log/php/error.log查看是否执行到该行
真正难的不是写几行 require_once，而是判断哪些类能安全地、无副作用地提前载入——这需要对项目依赖结构和类初始化行为有清晰认知。很多团队试了几次就放弃，往往是因为没意识到 preload 不是“越多越好”，而是“越精越稳”。
