PHP 自动加载机制详解

PHP 自动加载机制详解

---

一、自动加载的核心原理

✅ 什么是自动加载？

当使用 new ClassName() 时，PHP自动帮你找到并包含对应的文件。

// 传统写法
require_once 'User.php';
require_once 'Product.php';
$user = new User();

// 自动加载：无需手动包含
$user = new User(); // PHP自动找 User.php

---

二、自动加载的演进

📅 版本对比

版本	技术	状态
PHP 5.0+	__autoload()	已废弃
PHP 5.1.2+	spl_autoload_register()	推荐
Composer	PSR-4 标准	现代标准

---

三、spl_autoload_register() 详解

✅ 1. 基础用法

spl_autoload_register(function ($class_name) {
    $file = __DIR__ . '/src/' . $class_name . '.php';
    if (file_exists($file)) {
        require_once $file;
    }
});

$obj = new MyClass(); // 自动加载 src/MyClass.php

---

✅ 2. 多加载器支持

// 第一个加载器
spl_autoload_register('loader1');

// 第二个加载器
spl_autoload_register('loader2');

// 按注册顺序执行，直到类被加载

---

✅ 3. 命名空间处理

spl_autoload_register(function ($class) {
    $prefix = 'App\';
    $base_dir = __DIR__ . '/src/';
    
    $len = strlen($prefix);
    if (strncmp($prefix, $class, $len) !== 0) {
        return; // 不处理
    }
    
    $relative_class = substr($class, $len);
    $file = $base_dir . str_replace('\', '/', $relative_class) . '.php';
    
    if (file_exists($file)) {
        require $file;
    }
});

---

四、__autoload() 为什么被淘汰？

❌ 三大缺陷

1. 单注册限制 ：只能有一个 __autoload() 函数
2. 无法共存：多个库会冲突
3. 不够灵活：不能设置优先级

// PHP 5-7.4（已废弃）
function __autoload($class_name) {
    require_once $class_name . '.php';
}

---

五、Composer 自动加载

✅ 1. 配置文件

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

✅ 2. 使用

require_once 'vendor/autoload.php';
$user = new App\Models\User();

---

六、常见问题

❌ 问题1：大小写敏感

new MyClass(); // 找 MyClass.php
new myclass(); // 找 myclass.php（Linux系统会失败）

✅ 建议：类名用 PascalCase，文件名与类名一致

❌ 问题2：路径错误

// 确保路径正确
$file = __DIR__ . '/src/' . $class_name . '.php';

---

七、终极总结

特性	说明
推荐方式	spl_autoload_register()
现代标准	Composer + PSR-4
关键规则	类名与文件名严格匹配
调试技巧	添加日志，使用 class_exists()

✅ 最佳实践：使用 Composer 管理自动加载