Composer镜像不影响预加载，因镜像仅加速install/update阶段的包下载，不改变vendor中已安装文件的路径与结构；预加载依赖的是本地autoload_classmap.php等静态映射文件，而非镜像配置。
Composer 镜像包本身不参与预加载——预加载操作对象是 PHP 文件，不是 Composer 的包索引或镜像源。真正要预加载的，是你项目中通过 Composer 安装的依赖代码文件（如 vendor/illuminate/database/Connection.php），而不是镜像地址或 composer.json 里的 packagist.org 替换配置。
为什么改 packagist 镜像对预加载没影响
Composer 镜像（比如阿里云、腾讯云镜像）只在 composer install 或 update 阶段加速包下载，它不改变已安装包的文件结构、类名映射或自动加载逻辑。预加载发生在 PHP-FPM 启动时，此时所有依赖早已解压到 vendor/ 目录，镜像配置早已“功成身退”。
-
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/这类命令只影响后续 install/update 行为，不影响运行时 - 预加载脚本里
require_once '/path/to/vendor/autoload.php'或遍历autoload_classmap.php，读取的是本地文件路径，和镜像无关 - 即使你把镜像换成 packagist.org 原站，只要
vendor/内容不变，预加载效果完全一致
预加载真正依赖的 Composer 输出文件
预加载脚本需要稳定、可预测的类路径列表，而 Composer 提供的两类文件最常用：
-
vendor/composer/autoload_classmap.php：静态数组，键为类名，值为绝对路径；适合直接遍历 +opcache_compile_file() -
vendor/composer/autoload_static.php：Composer 2+ 默认生成，结构更紧凑，但含闭包，不能直接include；需用require加载后取$staticMap['classMap'] - 注意：
vendor/autoload.php本身不能直接丢进opcache.preload——它含动态逻辑（如if (file_exists())）、依赖运行时环境，违反预加载“无条件执行”原则
如何安全地把 Composer 依赖纳入预加载
核心是：只预加载你确认稳定、无条件、无环境分支的类文件。别扫全 vendor/，否则极易触发链接失败（如 Can't preload unlinked class）。
立即学习“PHP免费学习笔记（深入）”；
- 过滤掉测试类：
array_filter($files, fn($f) => !str_ends_with($f, 'Test.php')) - 跳过带条件逻辑的文件：如含
if (PHP_SAPI === 'cli')或if (app()->environment() === 'local')的服务提供者 - Laravel 项目建议优先预加载：
vendor/illuminate/support/ServiceProvider.php、vendor/illuminate/container/Container.php、vendor/illuminate/database/Connection.php - 用
opcache_compile_file()而非require_once：前者只编译不执行，规避类重复声明与副作用；后者可能触发构造函数或静态初始化
容易被忽略的权限与路径陷阱
预加载脚本在 PHP-FPM master 进程启动时以 opcache.preload_user 指定用户身份执行，不是 web 用户，也不是 root。
-
opcache.preload配置的路径必须是绝对路径，且 PHP-FPM 主进程有读取权限（常见错误：Permission denied） - 脚本内所有
opcache_compile_file()的参数也必须是绝对路径；__DIR__在 preload 上下文中指向的是脚本所在目录，不是 webroot - 若用工具如
spiral/preload生成脚本，检查它输出的路径是否含/var/www/app/这类真实部署路径，而非开发机路径 - 修改
preload.php后必须重启 PHP-FPM，仅 reload 不生效；FPM 日志里搜Failed to preload可快速定位失败点
预加载不是“越全越好”，而是“越稳越准越好”。类加载顺序、继承链完整性、路径权限这三点卡住，就等于整张预加载表作废。别指望改个镜像就能提速，真正的瓶颈在你 preload.php 里写了哪几行 opcache_compile_file()。
