项目一大,类名就会撞车:你的 User 和第三方库的 User 不能共存。命名空间解决的就是这个问题,它给类名加了一个前缀。
声明与引用
<?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。类名必须和文件名完全一致,大小写敏感。
手写自动加载
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 上暴露。