PHP 類別自動載入：__autoload 與 spl_autoload_register 實作指南

PHP 5 引入 __autoload 魔術函數，嘗試載入未定義的類別；PHP 5.1.2+ 推薦使用 spl_autoload_register 支援多載入器鏈。本文說明兩種機制用法、命名規範對應、最佳實踐與 Composer 整合。

1. 傳統 __autoload（單一載入器）

<?php
function __autoload($class) {
    // 假設類別檔案命名：class_類別名.php
    $file = 'class_' . ucfirst(strtolower($class)) . '.php';
    if (file_exists($file)) {
        include $file;
    }
}

// 使用
$user = new User(); // 自動觸發 __autoload('User') → 載入 class_User.php
$user->name = 'Leon';
$user->printName();
?>

缺點：全域僅能定義一個 __autoload，無法組合多個載入規則。

2. spl_autoload_register（多載入器鏈，推薦）

<?php
// 載入器 1：專案類別
spl_autoload_register(function($class) {
    $file = __DIR__ . '/src/' . str_replace('\\', '/', $class) . '.php';
    if (file_exists($file)) include $file;
});

// 載入器 2：第三方庫 (PSR-4)
spl_autoload_register(function($class) {
    $prefix = 'Vendor\\Package\\';
    if (strncmp($class, $prefix, strlen($prefix)) === 0) {
        $file = __DIR__ . '/vendor/' . str_replace('\\', '/', substr($class, strlen($prefix))) . '.php';
        if (file_exists($file)) include $file;
    }
});

// 使用
$obj = new \MyProject\User();
$lib = new \Vendor\Package\Library();

3. PSR-4 自動載入標準

現代 PHP 專案遵循 PSR-4：命名空間前綴對應目錄，類別名對應檔案名。

4. Composer 自動載入（生產環境標準）

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

執行 composer dump-autoload 產生 vendor/autoload.php，專案入口僅需：

require_once __DIR__ . '/vendor/autoload.php';

5. 效能優化：類別對應表

Composer 產生的載入器包含 classMap（類別名→檔案路徑陣列），避免 file_exists 磁碟 I/O，大幅提升載入速度。

常見問題排查

結論

• 新專案**直接使用 Composer + PSR-4**，零配置自動載入。
• 維護舊專案可改用 spl_autoload_register 逐步遷移。
• 理解自動載入機制有助於除錯「找不到類別」與優化啟動效能。