Composer Autoloader 的核心机制是通过 spl_autoload_register() 注册闭包，委托给 ClassLoader::loadClass() 实现命名空间到路径的映射查找，按 classMap → PSR-4 → PSR-0 → fallback 顺序匹配，仅首次使用时加载，后续走 PHP 内部缓存。
Composer Autoloader 的核心机制是什么
Composer 的自动加载不是靠魔法，而是靠 PHP 的 spl_autoload_register() 注册了一个闭包函数，这个函数最终委托给 ClassLoader 实例的 loadClass() 方法。它不解析 AST、不扫描文件，只做「命名空间前缀 → 文件路径」的映射查找。
关键点在于：所有类加载行为都发生在第一次 new 或 use 时，且仅触发一次；后续调用直接走 PHP 内部类缓存，ClassLoader 不再介入。
ClassLoader::loadClass() 的实际执行流程
当你访问一个未加载的类（如 MonologLogger），ClassLoader 会按顺序尝试以下查找方式，任一成功即返回并终止：
- 检查
$classMap（由composer dump-autoload --optimize生成的全量类名到路径的静态数组）——最快，O(1) - 遍历
$prefixLengthsPsr4，匹配 PSR-4 前缀（如Monolog\→vendor/monolog/monolog/src/），拼出路径后检查文件是否存在 - 遍历
$prefixesPsr0（已基本弃用，仅兼容老包），按旧式命名规则找Monolog/Logger.php或Monolog/Logger/ - 最后 fallback 到
$fallbackDirsPsr4（比如空命名空间或根命名空间的类）
注意：loadClass() 本身不 require 文件，它只调用 require $file —— 这个动作由 PHP 引擎在类定义解析阶段完成，失败则抛出 ClassNotFoundException。
为什么 vendor/autoload.php 只 require 一次就生效
vendor/autoload.php 并非“加载全部类”，它只是初始化一个 ClassLoader 实例，并用 spl_autoload_register() 把它的 loadClass() 注入 PHP 的自动加载队列。真正耗时的操作（文件 I/O、路径拼接、stat 检查）都在类首次被引用时才发生。
常见误解：
-
composer install时不生成classmap，autoload.php就很轻量（几百行） -
dump-autoload -o后，classMap会把所有类路径固化进内存数组，跳过路径拼接和文件存在性检查，但牺牲了开发时新增类的即时生效能力 - PSR-4 映射中末尾的
\必须严格匹配，App\不会匹配AppSub\Foo—— 这是前缀长度比对决定的，不是字符串strpos
调试 ClassLoader 行为的实用方法
直接看源码不如观察运行时行为。在关键位置加日志（不修改 vendor，用装饰器或临时 patch）：
require 'vendor/autoload.php';
$loader = require 'vendor/autoload.php';
$original = [$loader, 'loadClass'];
$loader->register(true); // 确保已注册
spl_autoload_unregister($original);
spl_autoload_register(function ($class) use ($original) {
echo "[LOAD] {$class}
";
return call_user_func($original, $class);
});
更轻量的方式是启用 Composer 的诊断模式：
COMPOSER_MEMORY_LIMIT=-1 composer dump-autoload -vvv 会打印所有映射规则；php -d display_errors=1 -d error_reporting=E_ALL test.php 2>&1 | grep "require" 可捕获实际加载的文件路径。
真正容易被忽略的是：PSR-4 的目录映射允许重叠（如 "App\" → src/ 和 "App\Test\" → tests/），但 ClassLoader 总是优先匹配最长前缀 —— 所以 AppTestFoo 会走 tests/ 而非 src/，这个逻辑藏在 $prefixLengthsPsr4 的键排序里，不是字典序，而是按前缀字符数倒序排列。
