不使用Composer的PHP自动加载与命名空间问题

咱们一步步拆解你的自动加载失败问题，找到根源并解决。先从你的代码和目录结构入手分析：

核心问题：类名到文件路径的映射不匹配 #

你的目录结构是：

根目录/
├─ test.php
└─ models/
   └─ MyClass.php

而MyClass的命名空间是MyProject，但你原自动加载器的逻辑是把MyProject\MyClass直接转成./MyProject/MyClass.php——可你的文件明明在./models/MyClass.php，路径完全对不上，这就是加载失败的主要原因。

分步修复方案 #

1. 修正自动加载器的路径映射逻辑 #

把命名空间MyProject和models/目录关联起来，替换你原有的自动加载函数：

namespace MyProject;

spl_autoload_register(function ($class_name) {
    // 移除命名空间前缀 "MyProject\"
    $class = str_replace('MyProject\\', '', $class_name);
    // 用__DIR__获取根目录路径，拼接成正确的文件路径
    $file = __DIR__ . '/models/' . $class . '.php';
    
    // 先检查文件是否存在再加载，避免致命错误
    if (file_exists($file) && is_readable($file)) {
        require_once $file;
    }
});

这里用__DIR__（当前脚本test.php所在的根目录）来拼接路径，比依赖include_path更可靠，不会因为环境配置或其他脚本修改路径而出问题。

2. 确保文件名与类名严格一致 #

注意大小写敏感（尤其是Linux/macOS环境）：

• 文件名必须是MyClass.php
• 类名必须是MyClass
• 命名空间必须是MyProject，和test.php的命名空间保持一致

MyClass.php的代码要确保正确：

<?php
namespace MyProject;

class MyClass {
    // 你的业务代码
}

3. 测试自动加载是否生效 #

在test.php里注册完自动加载器后，直接实例化类验证：

namespace MyProject;

// 上面修正后的自动加载器代码

$myObj = new MyClass();
var_dump($myObj); // 如果能输出对象信息，说明加载成功

进阶：遵循PSR-4规范（推荐） #

如果后续要扩展更多类，建议遵循PHP社区通用的PSR-4自动加载规范，调整目录结构为：

根目录/
├─ test.php
└─ src/
   └─ MyProject/
      └─ MyClass.php

然后用符合PSR-4的自动加载器，这样后续添加新类时无需修改加载逻辑：

spl_autoload_register(function ($class) {
    // 定义命名空间前缀
    $prefix = 'MyProject\\';
    // 前缀对应的基础目录
    $baseDir = __DIR__ . '/src/';
    
    // 检查当前类是否属于我们的命名空间
    $prefixLength = strlen($prefix);
    if (strncmp($prefix, $class, $prefixLength) !== 0) {
        // 交给其他自动加载器处理
        return;
    }
    
    // 获取去掉前缀后的类名
    $relativeClass = substr($class, $prefixLength);
    
    // 拼接成最终文件路径
    $file = $baseDir . str_replace('\\', '/', $relativeClass) . '.php';
    
    // 加载文件
    if (file_exists($file)) {
        require_once $file;
    }
});

内容的提问来源于stack exchange，提问作者RetroMime