PSR-4是PHP的自动加载标准，通过命名空间前缀与目录路径映射实现高效类加载。在composer.json中配置"psr-4"字段，如"App\": "src/"，可将命名空间对应到指定目录，类文件路径由命名空间层级决定，需确保目录结构与命名空间一致，并执行composer dump-autoload更新自动加载映射。
在 PHP 项目中，Composer 是最常用的依赖管理工具，而 PSR-4 是 Composer 默认采用的自动加载规范。理解并正确使用 PSR-4 能让类文件的加载更加高效、结构更清晰。
什么是 PSR-4
PSR-4（PHP Standard Recommendation 4）是由 PHP-FIG（Framework Interop Group）制定的一个自动加载标准，用于定义如何将类名映射到文件路径。它取代了较早的 PSR-0，更加简洁高效。
核心思想是：通过命名空间前缀与目录路径的映射关系，自动定位并加载对应的类文件。
PSR-4 的基本规则
PSR-4 规定以下几点关键规则：
- 类名必须对应其文件路径，且以命名空间为基础进行映射
- 下划线 _ 不再有特殊含义（与 PSR-0 不同）
- 每个命名空间前缀必须指向一个具体的文件系统路径
- 类文件必须以 .php 结尾，且文件名等于类的短名称（不含命名空间）
- 命名空间分隔符 \ 对应操作系统目录分隔符（如 / 或 \）
例如，若类名为 App\Controller\HomeController，PSR-4 会查找类似 src/Controller/HomeController.php 的文件。
在 composer.json 中配置 PSR-4
要在项目中启用 PSR-4 自动加载，需在 composer.json 文件中配置 autoload 字段：
{
"autoload": {
"psr-4": {
"App\\": "src/"
}
}
}
上面的配置表示：
- 所有以 App\ 开头的类，都从 src/ 目录开始查找
- 命名空间中的每一级对应一个子目录
- 最终类名对应文件名
比如：
- App\User → src/User.php
- App\Service\EmailService → src/Service/EmailService.php
- App\Http\Middleware\Auth → src/Http/Middleware/Auth.php
配置完成后，运行 composer dump-autoload 生成自动加载映射表。
多命名空间与目录映射
你可以为多个命名空间设置不同的源目录：
{
"autoload": {
"psr-4": {
"App\\": "src/",
"Tests\\": "tests/",
"Library\\": "vendor/mylib/src/"
}
}
}
这样不同模块的代码可以分散在不同目录，仍能被自动加载。
注意命名空间末尾的反斜杠 \\ 必须保留，否则 Composer 无法正确解析。
实际开发中的常见问题
使用 PSR-4 时容易遇到以下几个问题：
- 命名空间写错或大小写不一致：PHP 类名区分大小写，文件系统在 Linux 下也区分
- 目录结构与命名空间不匹配：如命名空间有 Admin\User，但缺少 Admin/ 目录
- 忘记执行 composer dump-autoload：修改配置后必须重新生成自动加载文件
- IDE 缓存未更新：有时即使配置正确，IDE 可能提示类找不到，清理缓存即可
建议保持命名空间与目录结构严格一致，并使用统一的命名风格（如 StudlyCaps）。
基本上就这些。PSR-4 让类自动加载变得直观且可预测，配合 Composer 使用非常方便。只要结构清晰、配置正确，就能避免“Class not found”这类低级错误。
