composer install --optimize-autoloader在FPM下几乎没用，因其生成的autoload_classmap.php是数MB全量数组，每次请求需完整反序列化或require，而实际仅用不到5%的类；OPcache对其缓存效率低，冷启动更慢；Composer 2.x默认生成的轻量autoload_static.php更高效且无需加-o。

composer install --optimize-autoloader 为什么在 FPM 下几乎没用

它生成的 vendor/composer/autoload_classmap.php 是一个全量数组，常达数 MB。PHP 每次请求都要完整 require_once 或反序列化它，而实际只用其中不到 5% 的类。OPcache 虽能缓存该文件，但它的结构（大数组 + 动态键）导致命中率低、内存占用高，反而拖慢冷启动。

真正起效的是 autoload_static.php——Composer 2.x 默认生成的轻量静态映射，体积小、结构扁平、OPcache 友好。你不需要加 -o，只要确保用了 Composer 2+ 和 PHP 7.4+，这个文件就已存在且被优先加载。

• 别手动运行 composer dump-autoload -o，除非你明确需要 classmap（比如兼容老脚本或 Swoole 热重载场景）
• 检查 vendor/composer/autoload_static.php 是否存在且非空；它比 autoload_classmap.php 更值得信任
• 若项目里有 "classmap": ["src/"] 这类配置，-o 会强制走 classmap，反而绕过 autoload_static.php

OPcache 配置不达标，再好的 autoload 也白搭

vendor/autoload.php 本身是 PHP 文件，它和所有被 require 的 autoload 文件（如 autoload_static.php）一样，依赖 OPcache 编译缓存。如果 OPcache 关闭、内存不足或频繁校验时间戳，首 N 次请求就会卡在文件解析阶段。

• 确认 opcache.enable=1（FPM）和 opcache.enable_cli=1（CLI 场景如 PHPUnit）都启用
• opcache.memory_consumption 至少设为 128，否则大项目的 autoload 文件可能被挤出缓存
• 生产环境必须设 opcache.validate_timestamps=0；设为 1 会导致每次请求都 stat 所有 autoload 文件
• 部署后执行 opcache_reset() 或重启 FPM，避免旧缓存残留

preload.php 里 require autoload_static.php 是安全的，但不能 require autoload.php

opcache.preload 只接受普通 PHP 文件路径，且要求这些文件在 PHP 进程启动时就能无副作用地执行完。而 vendor/autoload.php 会注册 spl_autoload_register 回调，这不是预加载阶段该做的事——强行 preload 会报 Cannot declare class 或 Class not found。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

立即学习“PHP免费学习笔记（深入）”；

但 autoload_static.php 是纯数据文件（定义静态数组），可安全 preload：

require_once __DIR__ . '/vendor/composer/autoload_static.php';
// 再补关键类，如 Laravel 的 Application
require_once __DIR__ . '/vendor/laravel/framework/src/Illuminate/Foundation/Application.php';

• preload 文件中禁止出现 new、class_exists()、function_exists() 等运行时逻辑
• 不要 preload 整个 vendor/ 目录，只列明确启动即需、且绝不会被其他方式重复加载的类文件
• 启用 --classmap-authoritative 后，务必在 preload 中也 require autoload_files.php（含 PSR-4 静态 require 列表）

部署命令必须带 --no-dev，否则 autoload 里混进测试路径

开发依赖（如 PHPUnit、phpspec）的 autoload 配置默认写在 autoload-dev 块里。如果不加 --no-dev，Composer 会把它们合并进主 autoload 文件，导致 autoload_psr4.php 里多出 "Tests\": "tests/" 这类条目——每次类查找都要多一次命名空间匹配和 stat()，尤其当 tests/ 目录很大时，性能损耗明显。

• 生产部署唯一可信命令：composer install --no-dev --optimize-autoloader
• 验证方式：打开 vendor/composer/autoload_psr4.php，确认没有 tests/、docs/、examples/ 等无关路径
• CI/CD 流程中漏掉 --no-dev 是最常见、最容易被忽略的性能陷阱

真正卡住性能的，往往不是 autoload 机制本身，而是 autoload 文件被反复解析、preload 写错导致进程启动失败、或者测试路径悄悄混进生产 autoload。这些点不清理干净，调再多次 composer dump-autoload -o 都只是在给问题打补丁。