Composer Classmap自动加载是如何工作的？（非PSR规范代码加载）

classmap 是 Composer 通过扫描指定路径中 PHP 文件提取类名并映射到文件路径的静态数组，生成于 composer dump-autoload 时，运行时直接键值查找并 require 文件，适用于非 PSR 规范的老代码。

Composer 的 classmap 自动加载机制，本质是“提前扫描 + 静态映射”，不依赖文件命名或目录结构，专为非 PSR-0/PSR-4 规范的老代码、工具类、函数库等设计。

classmap 是怎么生成的？

执行 composer dump-autoload（或安装/更新时）时，Composer 会递归扫描 composer.json 中 "autoload": {"classmap": [...]} 指定的路径（支持目录或具体文件），逐个解析 PHP 文件，提取其中声明的类、接口、trait 名称，并记录其所在文件的相对路径。最终生成一个扁平的 PHP 数组，形如：

[
  'SomeLegacyClass' => $vendorDir . '/mylib/lib/legacy.php',
  'HelperUtils'     => $vendorDir . '/mylib/src/utils.php',
]

这个数组被写入 vendor/composer/autoload_classmap.php，作为运行时的查找依据。

运行时如何触发加载？

当代码中首次使用一个尚未定义的类（如 new SomeLegacyClass()）时，PHP 会触发自动加载机制。Composer 注册的 ClassLoader::loadClass() 方法会被调用，它会：

标签： php word js json composer wordpress 工具 ssl ai