PHP SPL 自動加載機制深度解析：spl_autoload vs spl_autoload_call

兩大核心函數

啟用默認加載器

<?php
// 1. 設置類文件搜索路徑
set_include_path(get_include_path() . PATH_SEPARATOR . '/path/to/classes' . DIRECTORY_SEPARATOR);

// 2. 自定義文件後綴（可選）
spl_autoload_extensions('.php,.class.php,.inc');

// 3. 註冊 spl_autoload 到自動加載鏈
spl_autoload_register(); // 無參數時默認註冊 spl_autoload
?>

工作原理圖解

// 當代碼執行 new MyClass() 且類未定義時：
1. PHP 觸發自動加載機制
2. spl_autoload_call 依次調用注冊鏈中的函數：
   - spl_autoload (若已註冊)
   - 用戶自定義加載器 1
   - 用戶自定義加載器 2
   ...
3. 某加載器成功 require 文件 → 類定義完成 → 返回
4. 所有加載器均失敗 → 拋出 Error: Class 'MyClass' not found

自定義加載器最佳實踐

<?php
// PSR-4 聯合加載器示例
spl_autoload_register(function ($class) {
    // 命名空間前綴映射
    $prefix = 'App\\';
    $base_dir = __DIR__ . '/src/';

    if (strncmp($class, $prefix, strlen($prefix)) !== 0) {
        return; // 不屬於本加載器管轄
    }

    $relative_class = substr($class, strlen($prefix));
    $file = $base_dir . str_replace('\\', '/', $relative_class) . '.php';

    if (file_exists($file)) {
        require $file;
    }
});

// 也可註冊類方法
class Loader {
    public static function load($class) { /* ... */ }
}
spl_autoload_register(['Loader', 'load']);

// 異常處理：加載失敗拋出異常而非報錯
spl_autoload_register(function ($class) {
    if (!@include_once "classes/$class.php") {
        throw new Exception("Class $class not found");
    }
});
?>

常見誤區

• ❌ spl_autoload_register('my_loader') 後又手動調用 spl_autoload() —— 重複加載，浪費性能。
• ❌ 依賴 __autoload() —— PHP 7.2 棄用，8.0 移除，必須用 spl_autoload_register。
• ✅ 多個加載器按註冊順序執行，將通用加載器（如 Composer）放前面，業務加載器放後面。

Composer 自動加載原理

Composer 生成的 vendor/autoload.php 內部註冊了多個加載器（PSR-4、PSR-0、Classmap、Files），完美演示了 spl_autoload_call 鏈式調度機制。