vendor/autoload.php 不能预加载，因其仅注册 autoloader 回调、含动态逻辑且依赖运行时上下文；应预加载 autoload_classmap.php、autoload_files.php 及核心类文件，并确保入口脚本不再重复加载。
不能直接预加载 vendor/autoload.php，它会立刻报 Cannot declare class 或 Class not found —— 这不是配置问题，是设计限制。
为什么 vendor/autoload.php 不能放进 opcache.preload
因为 vendor/autoload.php 的本质是注册 spl_autoload_register() 回调，不定义任何类，也不加载任何类文件；它只在首次使用类时才触发文件读取和解析。OPcache 预加载要求脚本在 PHP 启动时就完成所有类定义，而 autoload.php 里混杂了条件判断、闭包、动态路径拼接，甚至可能调用未声明的函数（如 class_exists() 在 preload 阶段不可用），PHP 内核会直接拒绝加载。
- preload 阶段尚未初始化 autoloader，
require_once 'vendor/autoload.php'会成功执行，但后续请求中再次 require 它就会触发重复声明错误 - 它依赖
getcwd()、__DIR__等运行时上下文，而 preload 是在 FPM master 进程启动时执行，当前工作目录不可靠 - Composer 8.0+ 的
--apcu参数对 preload 完全无效——APCu 缓存的是查找结果，不是类定义本身
真正该 preload 的是哪些文件？
两类：一是 Composer 生成的静态映射表（不含逻辑），二是你项目里明确知道每次请求必用的核心类文件。前者提供路径清单，后者确保关键类进内存。
-
vendor/composer/autoload_classmap.php：纯数组，键为类名，值为相对路径，安全可 require -
vendor/composer/autoload_files.php：列出所有files类型自动加载项（如全局 helper 函数），也无逻辑 - 框架核心类，例如
Laravel的Illuminate/Foundation/Application.php、Symfony的HttpKernel/Kernel.php - 你自己
src/下的高频入口类，比如App/Http/Kernel.php、App/Providers/AppServiceProvider.php
别碰 autoload_static.php —— 它含闭包，preload 会失败；也别无脑 include 所有 classmap 条目，第三方包里常有 CLI 命令、define()、register_shutdown_function() 等副作用代码。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
怎么写一个安全可用的 preload.php
核心原则：绝对路径、无动态逻辑、无条件分支、无外部依赖。不要用 foreach + file_exists() 动态判断——file_exists() 在 preload 阶段可能返回 false（权限或路径问题），导致静默跳过；更糟的是，它让脚本变成“有条件执行”，违反 preload 要求。
- 先用
composer dump-autoload --optimize --classmap-authoritative --no-dev生成干净 classmap - 手写
preload.php，逐行require_once绝对路径（不是拼接）：require_once '/var/www/myapp/vendor/composer/autoload_classmap.php';<br>require_once '/var/www/myapp/vendor/composer/autoload_files.php';<br>require_once '/var/www/myapp/vendor/laravel/framework/src/Illuminate/Foundation/Application.php';<br>require_once '/var/www/myapp/app/Http/Kernel.php';
- 路径必须是硬编码绝对路径，不能含
__DIR__、dirname(__FILE__)或变量拼接 - 确保
opcache.preload指向这个文件，且 PHP 用户（如 www-data）有读取权限
opcache.preload 配置后仍报错的常见原因
最常被忽略的是：preload 脚本里 require_once 的每个文件，在运行时必须**永远不再被其他方式加载**。否则就是重复声明。
- FPM 子进程仍会执行
vendor/autoload.php—— 必须在入口脚本（如public/index.php）里删掉或注释掉require vendor/autoload.php，改用已 preload 的类 - 没关掉 classmap fallback：
--classmap-authoritative必须启用，否则 autoloader 还会尝试 PSR-4 扫描，可能加载到未 preload 的文件 - preload 脚本里漏了某个父类或接口，导致子类 preload 时找不到依赖，报
Class not found - 内存不够：
opcache.memory_consumption设太小，preload 失败但日志只显示 “Failed to preload” 不报具体原因
复杂点在于：你要手动维护 preload 列表。类增删后，必须同步更新 preload.php，否则要么漏 preload，要么重复加载。这不是自动化流程，而是部署 checklist 的一部分。
