spl_autoload_register vs __autoload：PHP 自動加載機制演進與最佳實踐

核心區別一覽

__autoload 簡單示例

function __autoload($class) {
    $file = $class . '.php';
    if (is_file($file)) require_once $file;
}
$a = new A(); // 自動載入 A.php

缺點：項目引入第三方庫時，雙方各自的 __autoload 會衝突覆蓋。

spl_autoload_register 進階用法

1. 註冊普通函數

function myLoader($class) {
    $file = __DIR__ . '/lib/' . $class . '.php';
    if (is_file($file)) require_once $file;
}
spl_autoload_register('myLoader');

2. 註冊類靜態方法（推薦）

class Loader {
    public static function load($class) {
        $file = __DIR__ . '/src/' . str_replace('\\', '/', $class) . '.php';
        if (is_file($file)) require_once $file;
    }
}
spl_autoload_register(['Loader', 'load']);
// 或 PHP 5.4+ 閉包寫法
spl_autoload_register(function($class) {
    $file = __DIR__ . '/src/' . str_replace('\\', '/', $class) . '.php';
    if (is_file($file)) require_once $file;
});

3. 多加載器協作機制

// 項目自有加載器
spl_autoload_register(['App\Loader', 'load']);
// Composer 加載器（內部已註冊）
require_once __DIR__ . '/vendor/autoload.php';
// 第三方庫加載器
spl_autoload_register(['ThirdLib\Loader', 'load']);

// 調用順序：按註冊順序依次嘗試，直到某加載器成功載入類

SPL 內建加載器

• spl_autoload()：默認實現，按 include_path 查找 類名.inc / 類名.php
• spl_autoload_call()：遍歷註冊棧調用各加載器
• spl_autoload_functions()：獲取當前註冊的所有加載器
• spl_autoload_unregister()：移除指定加載器

最佳實踐：PSR-4 + Composer

// composer.json
{
    "autoload": {
        "psr-4": {
            "App\\": "src/"
        }
    }
}
// 執行 composer dump-autoload 生成 vendor/autoload.php
// 入口文件僅需：
require_once __DIR__ . '/vendor/autoload.php';

Composer 內部使用 spl_autoload_register 註冊高性能映射表查找，支援類別映射、PSR-0/4、文件包含四種策略，生產環境建議 composer dump-autoload -o 生成優化映射。

遷移建議

1. 檢測代碼庫中是否存在 __autoload 定義
2. 重構為 spl_autoload_register 並按命名空間拆分加載器
3. 引入 Composer 管理依賴，統一自動加載入口
4. 刪除所有手寫 require/include，享受零配置加載