命名空间与自动加载

这篇讲 PHP 命名空间的作用与用法，以及现代 PHP 项目中不可或缺的自动加载机制——从手写 spl_autoload_register 到 Composer 的 PSR-4 规范。这是从"写脚本"到"做项目"的分水岭。

为什么需要命名空间

当项目变大、引入第三方库时，不同来源的代码可能出现同名的类或函数。命名空间解决了这个命名冲突问题。

简单类比：操作系统用文件夹来组织同名文件——photos/sunset.jpg 和 videos/sunset.jpg 互不干扰。命名空间就是 PHP 代码的"文件夹"。

命名空间基础

用 namespace 关键字声明当前文件所属的命名空间：

<?php
// 文件: src/Models/User.php
namespace App\Models;

class User {
    public function getName() {
        return "PHP User";
    }
}

使用 use 关键字导入其他命名空间的类：

<?php
// 文件: public/index.php
namespace App\Controllers;

use App\Models\User;  // 导入 User 类

$user = new User();
echo $user->getName();

也可以给导入的类起别名：

<?php
use App\Models\User as UserModel;
use App\Services\User as UserService;

$model = new UserModel();
$service = new UserService();

如果没有 use，可以使用完全限定名称（FQCN，以 \ 开头）：

<?php
$user = new \App\Models\User();

PHP 内置的类和函数属于根命名空间（\），所以在命名空间内调用 \Exception、\PDO 等内置类时，要么前面加 \，要么用 use 导入。

自动加载

没有自动加载时，每个文件都要手动 require 或 include——文件一多就是灾难。自动加载让 PHP 在首次使用类时自动找到并加载对应文件。

手写自动加载器

PHP 提供 spl_autoload_register() 来注册自动加载函数：

<?php
spl_autoload_register(function ($class) {
    $file = __DIR__ . '/' . str_replace('\\', '/', $class) . '.php';
    if (file_exists($file)) {
        require $file;
    }
});

// 现在可以直接 new，无需手动 require
$user = new App\Models\User();
?>

PSR-4 规范

PSR-4 是 PHP 社区公认的自动加载标准，核心规则：命名空间前缀对应一个基础目录，类的完全限定名（去掉前缀后）映射到文件路径。

例如配置：

{
    "autoload": {
        "psr-4": {
            "App\\": "src/"
        }
    }
}

那么 App\Models\User 类对应的文件路径就是 src/Models/User.php。

Composer 自动加载

实际项目中几乎都使用 Composer 管理依赖和自动加载。composer.json 中配置 PSR-4 映射后，运行 composer dump-autoload 即可生成 vendor/autoload.php：

<?php
// 项目入口文件只需要这一行
require __DIR__ . '/vendor/autoload.php';

// 之后所有符合 PSR-4 的类都会自动加载
use App\Models\User;

$user = new User();
?>

Composer 是目前 PHP 生态的标配工具。除了自动加载，它还管理第三方依赖（如 Guzzle、PHPUnit、Laravel 等），是现代化 PHP 开发的基石。

一句话小结

命名空间解决同名冲突，use 简化引用。自动加载通过 PSR-4 规范将类名映射到文件路径，Composer 提供了开箱即用的实现。学会了这个，就可以告别满屏 require，进入真正的项目化开发。下一篇讲文件与目录操作。

最后更新于 2026-06-16

超全局变量文件与目录操作