PHP __autoload 與 spl_autoload_register 自動載入機制深度解析

__autoload 簡易實作（僅供理解）

function __autoload($className) {
    $file = __DIR__ . "/classes/{$className}.php";
    if (file_exists($file)) require_once $file;
}

缺點：全域僅能有一個、無法解除註冊、例外處理困難、命名空間對應需自行處理。

spl_autoload_register 標準用法

<?php
// 1. 靜態方法載入器
class Loader {
    public static function loadClass($className) {
        $file = __DIR__ . "/src/" . str_replace('\\', '/', $className) . '.php';
        if (file_exists($file)) {
            require_once $file;
            return true;
        }
        return false;
    }
}
spl_autoload_register(['Loader', 'loadClass']);

// 2. 閉包載入器（匿名函數）
spl_autoload_register(function($className) {
    $file = __DIR__ . "/lib/" . str_replace('\\', '/', $className) . '.php';
    if (file_exists($file)) require_once $file;
});

// 3. 多載入器優先序（後註冊優先執行）
spl_autoload_register('autoload_v1');
spl_autoload_register('autoload_v2'); // 先嘗試 v2

// 4. 解除註冊
spl_autoload_unregister('autoload_v1');

PSR-4 自動載入標準

現代專案**不手寫載入器**，改用 Composer 產生 vendor/autoload.php，遵循 PSR-4：

// composer.json
{
    "autoload": {
        "psr-4": {
            "App\\": "src/",
            "Vendor\\Package\\": "packages/package/src/"
        }
    }
}

對應關係：App\Controller\UserController → src/Controller/UserController.php。

Composer 自動載入原理

1. 掃描 composer.json 所有 autoload 區塊。
2. 建立類別名 → 檔案路徑 對應表（vendor/composer/autoload_psr4.php、autoload_classmap.php）。
3. 註冊單一載入器函數 ComposerAutoloader::loadClass 至 spl_autoload_register。
4. 載入時先查 ClassMap（O(1)），再依 PSR-4 前綴對應路徑，最後回傳 false 讓下一個載入器嘗試。

最佳實踐

1. 永遠用 Composer：手寫載入器只適合教學、極簡專案。
2. 類別檔案嚴格對應命名空間：大小寫敏感（Linux），一致性至關重要。
3. 生產環境優化：composer dump-autoload -o 產生完整 ClassMap，載入速度最快。
4. 避免在載入器中執行邏輯：只做 require，初始化邏輯放在類別建構子或服務提供者。
5. 除錯技巧：spl_autoload_functions() 查看已註冊載入器；xdebug 斷點在載入器觀察解析路徑。