PSR-4 自动加载规范

封面图 • 2026-01-16 • PHP

PSR-4（PHP Standard Recommendation 4）是 PHP 社区定义的一套自动加载规范，用于统一和标准化 PHP 类的自动加载方式。它由 **PHP-FIG（PHP Framework Interop Group）** 组织制定，旨在让不同框架和库之间能够兼容地使用自动加载功能。

---

## 📘 PSR-4 简介

PSR-4 规定了如何通过类名映射到文件路径，从而实现类的自动加载。它比之前的 **PSR-0** 更加灵活和高效，尤其适合现代 PHP 项目中使用命名空间（Namespace）的结构。

---

## ✅ PSR-4 的核心规则

### 1. **命名空间与目录结构对应**

每个命名空间（namespace）必须对应一个文件系统目录（directory）。例如：

```php
namespace MyVendor\MyPackage;
```

对应的文件路径应为：

```
MyVendor/MyPackage/
```

### 2. **类名与文件名对应**

类名中的每个部分对应路径中的目录或文件名。例如：

```php
namespace MyVendor\MyPackage\SubNamespace\ClassName;
```

对应的文件路径为：

```
MyVendor/MyPackage/SubNamespace/ClassName.php
```

> 注意：类名 `ClassName` 对应文件 `ClassName.php`，不带 `.php` 后缀。

### 3. **前缀匹配**

PSR-4 允许你指定一个命名空间前缀（prefix），然后将该前缀映射到一个目录。例如：

```php
'App\\' => 'src/App/',
'Vendor\\' => 'vendor/Vendor/',
```

当加载 `App\Model\User` 时，会查找：

```
src/App/Model/User.php
```

---

## 📦 示例

### 命名空间结构

```php
namespace App\Models\User;
class User {}
```

对应的文件路径为：

```
src/App/Models/User/User.php
```

### 自动加载配置（使用 Composer）

在 `composer.json` 中配置自动加载：

```json
{
    "autoload": {
        "psr-4": {
            "App\\": "src/App/",
            "Vendor\\": "vendor/Vendor/"
        }
    }
}
```

运行 `composer dump-autoload` 生成自动加载文件后，就可以直接使用类而无需手动引入。

---

## 🧠 与 PSR-0 的区别

| 特性         | PSR-0                     | PSR-4                      |
|--------------|---------------------------|----------------------------|
| 命名空间支持 | 不支持                    | 支持                       |
| 文件名规则   | `Class_Name.php`          | `ClassName.php`            |
| 目录结构     | 多层嵌套                  | 与命名空间一致             |
| 性能         | 较低                      | 更高（更少的文件查找）     |

---

## 🛠️ 使用建议

- **命名空间** 是 PSR-4 的基础，务必正确使用。
- **Composer** 是最常用的 PSR-4 实现工具。
- 避免使用 `__autoload()` 或 `spl_autoload_register()` 手动实现，除非有特殊需求。

---

## 📚 参考文档

- [PSR-4 官方文档](https://www.php-fig.org/psr/psr-4/)
- [Composer 自动加载文档](https://getcomposer.org/doc/04-autoloading.md)

---

如果你需要我帮你写一个基于 PSR-4 的自动加载示例或者解释如何在项目中配置，可以继续问我！