composer dump-autoload -o 有效是因为它生成静态 classmap 映射，将类查找从耗时的目录遍历和文件检查转为内存数组键查找；不加 -o 则每次加载类都需动态拼路径、stat 文件，IO 开销大，尤其在容器或 NFS 环境下更明显。
PHP 8.5.5 下 Composer 自动加载慢，90% 不是 PHP 版本问题，而是 autoload 配置没对、优化没生效、或 APCu/OPcache 没配对。直接做三件事：生成 classmap 映射、启用 authoritative 模式、让 APCu 真正命中缓存。
composer dump-autoload -o 为什么必须加 -o 才有效
composer dump-autoload -o 把 PSR-4 规则提前解析成 vendor/composer/autoload_classmap.php（或新版本的 autoload_static.php）里的静态数组。不加 -o，每次 new 一个类都要遍历目录、拼路径、stat 文件——IO 开销大，尤其在容器或 NFS 上更明显。
- 加
-o后，类查找变成纯数组 key 查找，快一个数量级 - 它同时触发 PSR-4 路径规范化和文件去重，避免重复映射（比如
tests/被扫进 classmap 就拖慢首次加载） - PHP 8.5.5 对 opcode 缓存更敏感，未优化的 autoload.php 容易被 OPcache 排除或频繁失效
--classmap-authoritative 是提速关键，但别乱开
--classmap-authoritative（或简写 -a）让 Composer 完全信任 classmap，查不到就直接报 Class not found，跳过所有 fallback 查找（包括 PSR-4 目录扫描）。生产环境该开，开发环境慎用。
- 开启后，
vendor/composer/autoload_static.php中的$classMap变成唯一权威来源 - 新增类文件后必须重新运行
composer dump-autoload -o -a，否则类永远找不到 - 动态生成类（如 Proxy、Mock、Doctrine DQL 生成类）会失效，除非你手动把它们加进
"classmap"配置里 - CI/CD 中建议固化为
composer install -o --no-dev --classmap-authoritative，避免漏掉
APCu 缓存 autoload_classmap.php 的前提条件
APCu 不是“装了就加速”，它只缓存 autoload_classmap.php 或 autoload_static.php 里的映射数据，且仅在 CLI 和 Web 请求中都启用 apc.enable_cli=1 时才真正生效。
立即学习“PHP免费学习笔记（深入）”；
- 先确认扩展加载：
php -m | grep apcu，再检查 CLI 配置：php -i | grep 'apc.enable_cli'—— 必须输出On - 生成带 APCu 支持的 autoload：
composer dump-autoload -o --apcu，然后检查vendor/composer/autoload_static.php是否含apcu_fetch('composer.loaded') - APCu key 带路径哈希，换项目目录、改
composer.json或清 APCu 全局缓存都会使旧 key 失效 —— 不报错，但缓存未命中 - 若用 Docker，确保
php.ini在 CLI 和 FPM 下配置一致，别只配了 FPM 却忘了 CLI
autoload 配置里最容易踩的坑
很多“Class not found”不是代码问题，是 composer.json 里 autoload 写错了，或者改完没跑 dump-autoload。
-
"App\": "src/"缺末尾反斜杠 → 命名空间前缀不匹配，PSR-4 查找直接跳过 -
"classmap": ["src/"]扫描整个src/→ 把tests/、Examples/全塞进 classmap，映射文件体积暴涨、生成变慢 -
"files": ["src/helpers.php"]路径是相对composer.json的，不是相对vendor/autoload.php - 删掉
autoload-dev里和autoload重复的路径，否则dump-autoload会生成两套映射，autoload 文件翻倍大
PHP 8.5.5 的 OPcache 预加载（preloading）能进一步消除 autoload 开销，但它依赖稳定的 classmap，所以必须先确保 -o -a 生效，再配 preload 脚本 —— 否则预加载失败，反而拖慢启动。
