Composer的--classmap-authoritative选项有什么用？（深入理解）

--classmap-authoritative 强制 Composer 仅依赖 classmap 加载类，禁用 PSR-4/PSR-0 回退机制，解决性能开销与 classmap 不完整导致的隐式加载风险；需配合 --optimize-autoloader 使用以确保所有类被扫描入 classmap。

--classmap-authoritative 选项告诉 Composer 在运行时完全依赖生成的 classmap，不再尝试自动加载未被 classmap 覆盖的类。它不是“让 classmap 更准确”，而是强制关闭 PSR-0/PSR-4 自动加载回退机制。

它解决什么问题？

默认情况下，Composer 会先查 classmap（比如生成自 files 或 classmap 配置），没找到就按 PSR-4/PSR-0 规则去文件系统中找对应文件。这种“双重查找”带来两个隐患：

• 性能开销：每次类未命中 classmap，就得做一次文件路径拼接 + file_exists() 检查（尤其在大量未被 classmap 覆盖的类场景下）
• 不确定性风险：如果某类本该被 classmap 包含但因配置遗漏或生成疏忽没进去，它仍可能被 PSR-4 加载成功——这掩盖了 classmap 不完整的问题，上线后一旦启用 --classmap-authoritative 就直接报 Class not found

它怎么生效？

启用该选项后，Composer 的自动加载器会：

• 只查 vendor/composer/autoload_classmap.php 中的映射表
• 对任何未出现在该数组中的类名，直接返回 false，不执行 PSR-4/PSR-0 的路径推导和文件探测
• 这意味着：所有要使用的类，必须在 dump-autoload 时被明确收录进 classmap

典型使用方式：composer dump-autoload --classmap-authoritative（常配合 --optimize-autoloader 使用）。

哪些类会被放进 classmap？

不是所有类都会自动进入 classmap。只有满足以下任一条件的才会被扫描并记录：

标签： php laravel js json composer app