大型php项目必须用composer install --optimize-autoloader --classmap-authoritative --no-dev生成完整classmap并启用权威模式，否则自动加载仍慢；该模式禁用动态查找，要求类路径100%准确，暴露配置问题而非掩盖。
对大型 PHP 项目来说，Composer 自动加载慢不是配置问题，而是默认行为在“拼命找类”——必须用 classmap + authoritative 模式堵死所有动态查找路径，否则性能瓶颈无法突破。
为什么 composer dump-autoload -o 在大型项目里经常无效
很多人执行 composer dump-autoload --optimize 后发现 vendor/composer/autoload_classmap.php 文件没更新、类还是加载慢，根本原因是：该命令默认不重新扫描源码目录，只重写轻量级的 autoload_static.php 和 PSR 映射文件。
- classmap 只在
composer install或composer update时自动生成（除非你显式加了--classmap-authoritative或配置了"classmap": ["src/"]） - 仅运行
dump-autoload -o，等于“优化一个空映射表”，实际没类路径数据 - 验证方法：打开
vendor/composer/autoload_classmap.php，看数组是否为空或条目极少
生产部署必须用 composer install --optimize-autoloader --classmap-authoritative
这才是真正触发完整 classmap 扫描并启用权威模式的组合。它会：
- 递归扫描
autoload和autoload-dev下所有声明的路径（注意：--no-dev必须同时加，否则测试代码也进 classmap，白占内存） - 把每个
.php文件中定义的类、接口、trait 全部提取出来，写入autoload_classmap.php - 启用
--classmap-authoritative后，自动加载器彻底跳过file_exists()和 PSR-4 路径拼接逻辑，查不到就直接报错，不兜底
错误示例：Class App\Console\Commands\DeployCommand not found —— 不是命令写错了，是命名空间漏了反斜杠（namespace AppConsole\Commands; 应为 namespace App\Console\Commands;），导致扫描失败，classmap 里没它。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
APCu 缓存 classmap 只在 PHP-FPM 下有效
composer install --apcu-autoloader 看似高级，但有硬性前提：
- PHP CLI 模式下完全不生效（
apc.enable_cli=0是默认值） - PHP-FPM 下需确保
apc.enable_cli=1已关闭，且apc.shm_size足够（大型项目 classmap 数组常超 10MB） - APCu 缓存的是 classmap 数组本身，不是文件内容；若 classmap 更新但 APCu 未刷新，仍会加载旧路径
- CI/CD 中建议搭配
opcache_reset()或 FPM reload，避免缓存 stale 数据
开发环境别碰 --classmap-authoritative
本地开发时开这个参数，Tinker、PHPUnit 临时类、IDE 补全、Laravel Dusk 的运行时生成类都会崩。真正要保留灵活性：
- 开发环境用基础
composer install，保持 PSR-4 动态查找能力 - 禁用
"optimize-autoloader": true在composer.json里（它只是开关，不触发动作，还容易让人误以为已优化） - 精简
autoload路径：删掉tests/、examples/、docs/等非运行时目录，减少 classmap 体积和扫描耗时 - 检查
autoload-dev是否与autoload路径重叠——重叠会导致重复映射，autoload 文件体积翻倍，OPcache 压力陡增
最易被忽略的一点：classmap-authoritative 不是“更快的 autoload”，它是“更严格的 autoload”。它的价值不在提速本身，而在于把所有类加载行为收束到一张静态表里——这让你能真正感知哪些类被遗漏、哪些路径配置失效，而不是靠 fallback 机制掩盖问题。
