Composer通过解析composer.json中autoload的psr-4配置，生成命名空间与目录映射（如App\ → src/），执行dump-autoload后将映射写入vendor/composer/autoload_psr4.php，再通过spl_autoload_register注册自动加载器，运行时根据类名匹配命名空间前缀、替换为对应路径、转换类名为文件路径并包含文件，实现自动加载。
Composer 实现 PSR-4 自动加载机制的核心在于解析
composer.json中的
autoload配置，生成对应的映射关系，并通过自动加载器在运行时动态包含类文件。整个过程无需手动引入文件，只要遵循命名和目录结构规范，就能实现类的自动加载。
PSR-4 配置定义命名空间映射
在项目的
composer.json文件中，通过
autoload下的
psr-4字段声明命名空间与目录的对应关系。例如：
{
"autoload": {
"psr-4": {
"App\\": "src/",
"Tests\\": "tests/"
}
}
}
这表示：
-
App\ 命名空间下的类，对应
src/
目录 -
Tests\ 命名空间下的类，对应
tests/
目录
比如类
App\User的文件应位于
src/User.php，而
App\Service\OrderService应位于
src/Service/OrderService.php。
执行 dump-autoload 生成自动加载文件
配置完成后，运行以下命令：
composer dump-autoload
Composer 会根据 PSR-4 规则生成自动加载映射表，主要输出到
vendor/composer/autoload_psr4.php文件中。该文件返回一个数组，内容类似：
return [
'App\\' => [__DIR__ . '/../..' . '/src'],
'Tests\\' => [__DIR__ . '/../..' . '/tests'],
];
这个数组告诉自动加载器：当遇到以某个命名空间开头的类时，应该去哪个目录查找对应文件。
自动加载器在运行时解析类路径
Composer 的自动加载机制依赖 PHP 的
spl_autoload_register()。项目入口（如
index.php）引入
vendor/autoload.php：
require_once __DIR__ . '/vendor/autoload.php';
这个文件注册了 Composer 提供的自动加载函数。当代码中使用一个未加载的类（如
new App\User();），PHP 触发自动加载流程：
- 检查类名是否匹配某个 PSR-4 命名空间前缀（如
App\
） - 将命名空间前缀替换为对应目录路径（
src/
） - 将剩余的类名转换为相对路径（如
User
→User.php
） - 拼接完整路径并尝试
include
该文件
如果文件存在且类定义正确，类即可正常使用。
确保文件与命名空间一致
PSR-4 能正常工作的前提是严格遵守规则：
- 文件必须放在配置指定的目录下
- 命名空间必须完全匹配配置中的前缀（注意末尾的反斜杠）
- 类名与文件名必须一致（包括大小写）
- 子命名空间对应子目录（如
App\Controller\Home
→src/Controller/Home.php
）
任何不一致都会导致“Class not found”错误。
基本上就这些。Composer 通过配置解析、映射生成和运行时加载三步，实现了高效可靠的 PSR-4 自动加载。只要结构规范，开发时完全不用关心
require或
include。
