PSR-4自动加载机制通过命名空间映射实现类文件自动载入。1. 命名空间前缀如App\对应src/目录,类名与文件路径需一致;2. 在composer.json中配置"autoload": {"psr-4": {"App\\": "src/"}};3. 运行composer dump-autoload生成映射文件;4. 引入vendor/autoload.php即可在代码中直接使用类,无需手动包含文件。

Composer 的 PSR-4 自动加载机制让你无需手动引入类文件,只要遵循命名空间和目录结构规则,类就能被自动加载。配置 PSR-4 的核心是在 composer.json 文件中正确设置 autoload 字段。
1. 理解 PSR-4 基本规则
PSR-4 是 PHP 的一个自动加载标准,它将命名空间前缀映射到指定的文件目录。类文件必须放在对应命名空间路径的目录下,文件名与类名一致,且使用 .php 扩展名。
- 命名空间前缀如
App\对应源码目录如src/ - 类
App\Controller\UserController应位于src/Controller/UserController.php - 目录结构需与命名空间层级一致
2. 配置 composer.json 中的 autoload
在项目根目录的 composer.json 文件中添加或修改 autoload 部分:
{
"autoload": {
"psr-4": {
"App\\": "src/"
}
}
}
说明:
-
App\\是命名空间前缀,注意结尾有两个反斜杠(转义) -
src/是相对于项目根目录的源码路径 - 你可以添加多个命名空间映射
3. 生成自动加载文件
配置完成后,运行以下命令生成自动加载映射:
composer dump-autoload
这会重建 vendor/composer/autoload_psr4.php 文件,使你的映射生效。
如果在生产环境优化性能,可使用:
composer dump-autoload --optimize
该命令会生成更高效的类映射表。
4. 在代码中使用自动加载
确保你的类文件正确声明命名空间:
在入口文件(如 index.php)中引入 Composer 的自动加载器:
index();基本上就这些。只要命名空间、目录结构和 composer.json 配置一致,PSR-4 就能正常工作。










