Composer如何优化生产环境_Composer性能提升建议方案-composer-PHP中文网

生产环境 autoload 慢主因是 vendor/autoload.php 加载时反复扫描目录、构建映射并触发大量 stat()/file_exists()；真正有效优化是精准控制 classmap 内容、禁用 dev 依赖，并必须用 composer install --optimize-autoloader --no-dev 部署，而非 dump-autoload -o——后者在 composer 2+ 中已失效，不重建 autoload_classmap.php，且易因 classmap 不全导致 class not found。

composer如何优化生产环境_composer性能提升建议方案

生产环境 autoload 慢，90% 不是类加载本身拖慢，而是 vendor/autoload.php 加载时反复扫描目录、构建映射、触发大量 stat() 和 file_exists()；真正有效的优化不是“多加几个 -o”，而是精准控制 classmap 内容、禁用 dev 依赖，并用 composer install --optimize-autoloader --no-dev 部署——dump-autoload -o 在 Composer 2+ 中已失效，且大概率导致 Class not found 错误。

为什么 `composer dump-autoload -o` 在生产环境不安全

dump-autoload -o 在 Composer 2.0+ 中只是 --classmap-authoritative 的别名，行为已彻底改变：它会强制禁用 PSR-4 动态查找，但不保证 classmap 覆盖全部类。一旦漏掉某个类（比如空目录、条件加载的类、或 files 类型引入的辅助文件里 new 出来的类），就会直接报错。

它不重建 autoload_classmap.php，多数情况下生成的文件根本没更新，甚至压根不存在
CI/CD 构建时若用了这个命令，本地能跑、线上炸锅是常态
检查 vendor/autoload.php，如果里面没写 'classmap-authoritative' => true，说明根本没生效

必须用 `composer install --no-dev --optimize-autoloader --classmap-authoritative`

只有 composer install（或 update）阶段才会真正扫描并写入 classmap；install 命令同时做到三件事：跳过 require-dev 包、生成 classmap、禁用 dev 相关 autoload 规则。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

--no-dev 是硬性前提：dev 依赖的类不会进 classmap，残留它们会让 autoloader 回退到慢路径
若项目用了 "autoload-dev": {"psr-4": {"Tests\": "tests/"}}，但没加 --no-dev，这些测试类会混进 classmap，白白增大数组体积、拖慢反序列化
"optimize-autoloader": true 写在 composer.json 里只是默认开关，不触发实际动作；它不能替代命令行参数

验证是否真生效：看 `autoload_real.php` 和系统调用

光看命令没报错不等于优化成功。关键检查点有两个：

查看 vendor/composer/autoload_real.php 中的 findFile() 方法——如果只剩 if ($classMap = $this->classMap) 分支，且完全删掉了 foreach ($this->prefixesPsr4 相关逻辑，才算真正“权威”
用 strace -e trace=openat php -r "new AppHttpControllersHomeController();" 观察：优化后应几乎看不到对 .php 文件的 openat 调用，说明跳过了所有 stat() 系统调用
检查 vendor/composer/autoload_classmap.php 是否有实质内容（非空数组），且大小明显增大（含所有类路径）

`classmap-authoritative` 报 `Class not found`？先查 classmap 漏了啥

--classmap-authoritative（或 -a）不是“加速开关”，而是“断言模式”：查不到就抛错，不 fallback。报错说明 classmap 不完整，不是配置错了。

检查 vendor/composer/autoload_classmap.php 里有没有你刚加的类，比如 AppConsoleCommandsDeployCommand
常见原因是命名空间末尾少写了反斜杠："App\": "app/" 对，"App": "app/" 错
files 类型加载（如全局函数文件）不会进 classmap，开了 -a 后它们仍能工作，但别误以为所有 autoload 都走 classmap
Laravel 中通过 AppServiceProvider::boot() 动态绑定的接口实现，不对应真实类文件，自然不在 classmap 里——这跟 -a 无关，是设计使然