composer dump-autoload -o 在 Composer 2.0+ 中已废弃且静默忽略，不提升性能；真正有效的是 composer.json 中 "optimize-autoloader": true、合理 classmap 和启用 apcu-autoloader。
直接说结论：composer dump-autoload --optimize（或简写为 -o）在现代 Composer 版本（2.0+）中**已废弃且默认不生效**，强行使用会静默忽略，不会提升性能——反而可能掩盖真实瓶颈。
为什么 --optimize 不再起作用？
Composer 2.0 起彻底移除了“类映射优化”（即生成 classmap 全量数组）的默认行为。过去 --optimize 会把所有 PSR-4/PSR-0 类扫描进一个大数组，避免每次 require 时的文件查找，但代价是内存占用高、生成慢、热更新不敏感。
现在 Composer 默认启用更智能的 classmap 自动合并机制（仅对明确声明的 classmap 区域）和更快的 PSR-4 路径解析器，--optimize 已无对应实现。
- 运行
composer dump-autoload -o不报错，但vendor/autoload.php内容与不加-o完全一致 -
composer show -s输出中不再显示optimize-autoloader相关提示 - 源码中该 flag 已被标记为
@deprecated并空实现
真正影响 autoload.php 性能的关键配置
实际生效、可量化提升的设置集中在 composer.json 的 autoloader 配置段，而非命令行参数：
立即学习“PHP免费学习笔记（深入）”；
-
"optimize-autoloader": true—— 注意：这是 JSON 字段名，不是命令行 flag；它控制是否为 PSR-4 命名空间生成静态映射（非全量 classmap），仅在dump-autoload时生效 -
"classmap": ["src/Support", "legacy/"]—— 显式声明需扫描的目录，Composer 会生成紧凑的 class-to-file 查找表，比动态 PSR-4 解析快 10%~20% - 避免在
"autoload"中混用大量"files"—— 每个文件会在每次请求时require_once，累积成性能热点
推荐组合：
{
"autoload": {
"psr-4": {
"App\\": "src/"
},
"classmap": ["src/Contracts/", "src/Exceptions/"]
},
"config": {
"optimize-autoloader": true,
"apcu-autoloader": true
}
}
APCu 加速器才是现代最优解
PHP 7.0+ 环境下，开启 apcu-autoloader 比任何静态优化都有效——它把类路径映射缓存在共享内存，跳过全部文件系统操作。
- 需确保 PHP 启用了
apcu扩展（extension=apcu.so）且未禁用用户缓存（apc.enable_cli=1CLI 下也生效） -
"apcu-autoloader": true必须写在composer.json的"config"下，运行composer dump-autoload后生效 - 首次请求稍慢（需填充 APCu），后续请求类加载耗时趋近于 0μs
- 注意：开发环境若频繁改类名/命名空间，需手动清 APCu（
apcu_clear_cache('user')）或禁用该选项
容易被忽略的加载路径陷阱
即使配置正确，以下情况仍会导致 autoload.php 性能下降：
- 项目根目录下存在大量未被
.gitignore排除的临时文件（如*.php.swp、Thumbs.db），Composer 扫描时会尝试解析它们 -
vendor/composer/autoload_classmap.php文件过大（>5MB）——说明classmap配置了不该扫的目录（如node_modules或日志目录） - 使用了第三方包的
files自动加载（如monolog的src/monolog.php），这类文件无法被 APCu 缓存，每次请求都 require - CLI 环境下未启用 APCu（
apc.enable_cli=0是默认值），导致apcu-autoloader形同虚设
检查方法：php -r "var_dump(apcu_fetch('composer:autoload'));" 返回 bool(false) 即未命中缓存。
