Composer 的 ClassMapGenerator 是一个用于自动发现 PHP 类、接口或 trait 所在文件路径的工具。它通过扫描指定目录中的 PHP 文件，解析文件内容，提取出其中定义的类名，并将类名与其对应的文件路径建立映射关系，最终生成一个类映射表（class map）。这个映射表被 Composer 用来实现高效的自动加载。
扫描目录并收集 PHP 文件
ClassMapGenerator 从你配置的源目录（如 src/ 或 lib/）开始递归遍历所有 PHP 文件。它只处理以 .php 结尾的文件（也可自定义扩展名），跳过注释、测试文件或其他非必要文件。
它会：
- 遍历目录树，列出所有符合条件的 PHP 文件
- 过滤掉不存在或不可读的文件
- 准备这些文件供后续分析
解析文件内容以提取类信息
对每一个 PHP 文件，ClassMapGenerator 并不会执行它，而是使用 PHP 的词法分析器 token_get_all() 来解析源码。这样可以在不运行代码的前提下，准确识别出文件中声明的类、接口和 trait。
处理过程包括：
- 读取文件内容为字符串
- 使用 token_get_all() 将源码分解成 token 流
- 遍历 tokens，查找 T_CLASS、T_INTERFACE、T_TRAIT 等关键字
- 提取紧跟其后的标识符作为类名
- 注意命名空间（T_NAMESPACE）的存在，构建完整的 FQCN（全限定类名）
例如，遇到如下代码：
namespace App\Utils;
class FileReader { }
ClassMapGenerator 会识别出完整类名为 App\Utils\FileReader，并记录它位于当前文件。
生成类映射数组
每识别出一个类，就会在内存中构建一个关联数组条目：
[
'App\\Utils\\FileReader' => '/path/to/project/src/Utils/FileReader.php',
]
这个数组就是 class map。它直接告诉 Composer 自动加载器：当请求某个类时，应包含哪个文件。
生成完成后，这个 class map 通常会被写入 vendor/composer/autoload_classmap.php，由 Composer 的自动加载机制调用。
性能优势与使用场景
相比在运行时动态解析文件，class map 是提前生成的静态映射，因此加载类时只需一次数组查找，速度非常快。
它适用于：
- 没有遵循 PSR-4 命名规范的传统项目
- 需要最大加载性能的生产环境
- 包含大量类但分布不规则的代码库
执行 composer dump-autoload --optimize 会强制生成 class map 以提升性能。
基本上就这些。ClassMapGenerator 不依赖命名约定，靠真实解析文件内容来工作，虽然慢一点，但准确且兼容性强。Composer 在背后默默做这些事，让自动加载既灵活又高效。
