详解Composer的--classmap-authoritative选项（性能优化）

启用 --classmap-authoritative 后，Composer 仅通过 classmap 加载类，跳过 PSR-0/PSR-4 目录扫描，大幅提升性能；但要求所有类必须已存在于 autoload_classmap.php 中，否则报错。

启用 --classmap-authoritative 会让 Composer 完全依赖生成的 classmap 加载类，跳过 PSR-0/PSR-4 的文件扫描逻辑，显著提升自动加载性能，尤其适合生产环境。

它到底做了什么？

默认情况下，Composer 的自动加载器会先查 classmap，没命中再按 PSR-0/PSR-4 规则遍历目录找文件。开启该选项后，自动加载器只查 classmap，不回退到目录扫描。这意味着：所有可自动加载的类必须已出现在 classmap 中，否则会抛出 Class not found 错误。

这个 classmap 来自 composer dump-autoload --optimize（或简写为 -o）生成的 vendor/composer/autoload_classmap.php 文件。

什么时候该用它？

适合对性能敏感、且代码结构稳定的场景：

• 线上生产环境（类不会动态增删）
• 部署后不再运行 composer install 或 composer update 的容器化应用
• 使用 OPcache 且希望减少文件 stat 和目录遍历开销的服务
• 大型项目中 PSR-4 映射目录层级深、文件多，扫描耗时明显

怎么启用并确保安全？

两种等效方式：

标签： php js json composer 容器化应用