PHP 自動載入機制全解析：從 __autoload 到 spl_autoload_register 最佳實踐

PHP 類自動載入演進指南：require_once → __autoload → spl_autoload_register

隨著專案規模增長，手動 require 大量類文件不再現實。PHP 5 引入自動載入機制，經歷 __autoload() 到 spl_autoload_register() 的演進，現代框架（Composer、PSR-4）皆建立於後者之上。本文系統梳理三種載入方式的原理、優缺點與實戰代碼。

1. 傳統手動載入：require / include

<?php
// A.php
class A { public function __construct() { echo 'Got it.'; } }

// index.php
require('A.php');
$a = new A();

痛點： 類增多時需大量 require，維護困難，易遺漏或重複載入。

2. __autoload() 魔術函數（PHP 5.0+，已棄用於 7.2，移除於 8.0）

當實例化未定義類時，PHP 自動調用全域函數 __autoload($class)。

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

缺陷： 全域僅能定義 一個 __autoload。若引入多個第三方庫，其命名規則不同，所有邏輯須塞進同一函數，導致極其臃腫、難以維護。

3. spl_autoload_register() 現代標準（推薦）

註冊多個自動載入器，形成隊列，按註冊順序依次嘗試載入，完美解決多庫共存問題。

<?php
// 1. 普通函數
function loader($class) {
    $file = $class . '.php';
    if (is_file($file)) require_once($file);
}
spl_autoload_register('loader');

// 2. 匿名函數 (PHP 5.3+)
spl_autoload_register(function($class) {
    $file = $class . '.php';
    if (is_file($file)) require_once($file);
});

// 3. 類靜態方法
class Loader {
    public static function loadClass($class) {
        $file = $class . '.php';
        if (is_file($file)) require_once($file);
    }
}
spl_autoload_register(['Loader', 'loadClass']);
// 或 spl_autoload_register([__CLASS__, 'loadClass']);
// 或 spl_autoload_register([$this, 'loadClass']);

4. 實戰進階：命名空間對應目錄結構 (PSR-4 風格)

<?php
// autoload.php 入口
define('SDK_PATH', __DIR__);
require_once SDK_PATH . '/common/functions.php';
require_once SDK_PATH . '/common/config.php';

spl_autoload_register(function ($class) {
    // 僅處理 YJC\Wechat 命名空間下的類
    if (false !== stripos($class, 'YJC\Wechat')) {
        // 將命名空間分隔符轉為目錄分隔符，去掉前綴長度
        $relative = substr($class, 10); // strlen('YJC\Wechat') = 10
        $file = __DIR__ . '/' . str_replace('\\', DIRECTORY_SEPARATOR, $relative) . '.php';
        if (is_file($file)) require_once($file);
    }
});

關鍵點：

• 入口文件定義常量 SDK_PATH（或 BASE_PATH），所有 require 使用絕對路徑，避免相對路徑混亂。
• 載入器中根據命名空間前綴分發，實現多庫隔離。
• 生產環境建議使用 Composer 生成的 vendor/autoload.php，遵循 PSR-4 標準，無需手寫。

5. 總結與建議

最佳實踐： 拥抱 Composer + PSR-4，專注業務邏輯，勿重複造輪子。