写给愿意动手的 PHP 开发者
PHP学习网 PHP学习网
公告PHP学习网为公益性网站,致力于为广大PHP爱好者服务
首页/ PHP 教程/ 面向对象/ 命名空间与 PSR-4 自动加载
面向对象 命名空间PSR-4自动加载

命名空间与 PSR-4 自动加载

为什么需要命名空间、namespace 与 use 的写法、PSR-4 的目录映射规则,以及手写一个最简单的自动加载器。

项目一大,类名就会撞车:你的 User 和第三方库的 User 不能共存。命名空间解决的就是这个问题,它给类名加了一个前缀。

声明与引用

PHP
<?php
namespace App\Service;

use App\Model\User;
use PDO;

class UserService
{
    public function __construct(private PDO $db) {}

    public function find(int $id): ?User
    {
        // ...
        return null;
    }
}

namespace 必须是文件的第一条语句(declare 除外)。use 只是给长名字起个短别名,不会真的加载文件。

完全限定名以反斜杠开头:\App\Model\User。不写开头的反斜杠,会被当作当前命名空间下的相对名,这是「类找不到」最常见的原因。

PSR-4 的映射规则

PSR-4 规定:命名空间前缀对应一个目录,去掉前缀后的部分按反斜杠转成目录分隔符,最后加 .php。

例如前缀 App\ 映射到 src/,那么 App\Service\UserService 对应的文件就是 src/Service/UserService.php。类名必须和文件名完全一致,大小写敏感。

手写自动加载

PHP
spl_autoload_register(function (string $class): void {
    $prefix = 'App\\';
    $baseDir = __DIR__ . '/src/';
    if (strncmp($class, $prefix, strlen($prefix)) !== 0) {
        return;
    }
    $relative = substr($class, strlen($prefix));
    $file = $baseDir . str_replace('\\', '/', $relative) . '.php';
    if (is_file($file)) {
        require $file;
    }
});

这段代码就是 Composer 自动加载的核心逻辑。实际项目直接用 composer 的 autoload,改 composer.json 里的 psr-4 配置即可,改完执行 composer dump-autoload。

常见错误

  • 文件名和类名大小写不一致:Linux 下区分大小写,Windows 下不区分,本地能跑线上挂。
  • 一个文件里写多个类:自动加载按类名找文件,找到的却是另一个类。一个文件一个类。
  • 忘了 use:new User() 在当前命名空间下找不到,报 Class not found。
部署到 Linux 前,务必在 Linux 环境跑一遍。大小写问题只在 Linux 上暴露。

文中提到的函数

接着读