PHP __autoload() 類別自動載入機制詳解

從 __autoload 到 spl_autoload_register 的演進與實務

PHP 5 引入 __autoload() 魔術函數，讓類別檔案在實例化時自動引入，避免冗長的 include 清單。現代開發建議使用 spl_autoload_register() 取代。

基本 __autoload 範例

<?php
function __autoload($className) {
    // 命名規範：類別名對應檔名，如 User -> User.php
    require_once $className . '.php';
}

$obj  = new MyClass1(); // 自動引入 MyClass1.php
$obj2 = new MyClass2(); // 自動引入 MyClass2.php

進階：Discuz 風格的靜態類別自動載入

<?php
if (function_exists('spl_autoload_register')) {
    spl_autoload_register(['core', 'autoload']);
} else {
    function __autoload($class) {
        return core::autoload($class);
    }
}

class core {
    public static function autoload($class) {
        // 依據命名空間/前綴對應目錄
        $file = ROOT_PATH . 'source/class/' . $class . '.php';
        if (is_file($file)) include $file;
    }
}

spl_autoload_register 優勢

• 支援多個自動載入器，避免函數衝突。
• 可指定優先順序、拋出例外而非致命錯誤。
• 符合 PSR-4 規範，配合 Composer 自動載入器無縫整合。

命名規範建議

關鍵提醒

__autoload() 專為「類別不存在」時觸發設計！ 許多框架利用此機制實現類別檔案自動載入。PHP 7.2+ 已棄用 __autoload，PHP 8.0 移除，請全面改用 spl_autoload_register()。