PHP 自動加載機制深度解析：從 __autoload 到 spl_autoload_register 與 PSR-4 規範

自動加載演進

早期使用 __autoload() 魔術方法，但只能定義一次，無法多庫共存。PHP 5.1.2 引入 spl_autoload_register()，支持註冊多個加載器、優先級控制、異常捕獲，現為標準做法。PHP 7.2+ 棄用 __autoload，請遷移至 SPL 方式。

spl_autoload_register 核心用法

單一加載器

spl_autoload_register(null, false); // 清空現有
spl_autoload_extensions('.php, .class.php'); // 設置默認擴展

function classLoader($class) {
    $file = 'classes/' . strtolower($class) . '.class.php';
    if (file_exists($file)) include $file;
}
spl_autoload_register('classLoader');

$norman = new norman(); // 自動加載 classes/norman.class.php

多加載器鏈（按註冊順序嘗試）

function classLoader($class) { /* 加載 classes/ 下 .class.php */ }
function libLoader($class) { /* 加載 libs/ 下 .lib.php */ }

spl_autoload_register('classLoader');
spl_autoload_register('libLoader'); // classLoader 失敗時嘗試 libLoader

接口/抽象類加載

同樣觸發自動加載，確保實現類加載前接口已定義。

標準化項目掃描加載器

spl_autoload_register('autoload');
function autoload($class, $dir = null) {
    is_null($dir) && $dir = '/path/to/project';
    foreach (scandir($dir) as $file) {
        $path = $dir . $file;
        if (is_dir($path) && $file[0] !== '.') {
            autoload($class, $path . '/'); // 遞歸子目錄
        } elseif (preg_match('/\.php$/i', $file) && $file[0] !== '.' && $file[1] !== '_') {
            $name = basename($file, '.php');
            $name = basename($name, '.class.php');
            if ($name === $class) include $path;
        }
    }
}

框架級加載器實現（LotusPHP 風格）

核心特性：

• 掃描構建 類名→文件路徑映射表，緩存到持久存儲（文件/Redis/APCu）。
• 開發模式每請求掃描，生產模式僅載入緩存映射，極快。
• 使用 token_get_all() 解析文件提取類/接口/函數名，而非靠文件名推斷。
• 支持函數庫自動加載（全量 include 定義函數的文件）。
• 檢測重複類定義、解析錯誤、文件變更（md5+size 判斷）。

關鍵方法：

class LtAutoloader {
    public $autoloadPath = [];      // 掃描目錄
    public $devMode = true;         // 開發/生產模式
    public $allowFileExtension = ['php','inc'];
    public $skipDirNames = ['.svn','.git'];
    
    public function init() { /* 掃描構建映射、註冊 loadClass */ }
    protected function loadClass($className) { /* 映射查找 include */ }
    protected function scanDirs($dirs) { /* 遞歸掃描、解析 token、構建映射 */ }
    protected function parseLibNames($src) { /* token_get_all 解析類/接口/函數 */ }
    // ... 緩存、去重、錯誤處理邏輯
}

簡易模式：set_include_path + 默認加載器

set_include_path(implode(PATH_SEPARATOR, [
    get_include_path(),
    __DIR__ . '/services',
    __DIR__ . '/printers'
]));
spl_autoload_register(); // 使用內置 spl_autoload（按 include_path 查找 $class.php）

要求文件名與類名完全一致（含大小寫），目錄結構扁平。

PSR-4 規範：現代標準

PSR-4 定義：命名空間前綴 → 基礎目錄 映射，類名尾部對應文件名，命名空間分隔符 \ 對應目錄分隔符。

// 示例映射
'App\\' => __DIR__ . '/src'
'Vendor\\Package\\' => __DIR__ . '/vendor/package/src'

// 類 App\Controller\UserController → src/Controller/UserController.php
// 類 Vendor\Package\Service\MailService → vendor/package/src/Service/MailService.php

Composer 自動生成符合 PSR-4 的 vendor/autoload.php，現代框架（Laravel、Symfony、ThinkPHP 5+）均遵循此標準。

最佳實踐建議

1. 新項目直接使用 Composer + PSR-4，零配置自動加載。
2. 遺留項目逐步遷移：先建立映射表緩存機制，再引入 PSR-4 結構。
3. 避免在自動加載中執行業務邏輯、拋出不可捕獲異常、使用相對路徑。
4. 生產環境務必啟用 OpCache + 類映射緩存（composer dump-autoload -o）。