PHP __autoload 自動加載機制原理與最佳實踐

__autoload 魔術方法機制

PHP 5 引入 __autoload() 魔術方法，當實例化未定義的類時自動觸發，避免手動 require/include。但 PHP 7.2 棄用，8.0 移除，現代項目應使用 spl_autoload_register() 或 Composer PSR-4 自動加載。

傳統 __autoload 示例（僅供理解歷史代碼）

<?php
function __autoload($class_name) {
    // 將類名中的下劃線轉為目錄分隔符
    // 例：Http_File_Interface → Http/File/Interface.php
    $path = str_replace('_', '/', $class_name);
    $file = $path . '.php';
    if (file_exists($file)) {
        require_once $file;
    }
}

// 使用時自動加載 Http/File/Interface.php
$obj = new Http_File_Interface();
?>

現代標準：spl_autoload_register + PSR-4

spl_autoload_register() 支持多個加載器、異常處理、優先級控制，是現代框架的基礎。

手動實現 PSR-4 加載器

<?php
spl_autoload_register(function ($class) {
    // 項目命名空間前綴
    $prefix = 'App\\';
    $base_dir = __DIR__ . '/src/';

    // 僅處理本項目命名空間
    $len = strlen($prefix);
    if (strncmp($prefix, $class, $len) !== 0) {
        return;
    }

    // 獲取相對類名
    $relative_class = substr($class, $len);
    // 命名空間分隔符 → 目錄分隔符，類名 → 文件名
    $file = $base_dir . str_replace('\\', '/', $relative_class) . '.php';

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

// 使用
$user = new App\Model\User();
$service = new App\Service\OrderService();
?>

生產環境：Composer 自動加載

// composer.json
{
    "autoload": {
        "psr-4": {
            "App\\": "src/"
        }
    }
}

// 執行 composer dump-autoload 後
require __DIR__ . '/vendor/autoload.php';

// 即可直接使用
$user = new App\Model\User();

核心差異對比

建議：新項目直接使用 Composer PSR-4；維護舊項目時，將 __autoload 遷移至 spl_autoload_register 以兼容 PHP 8+。