PHP 惰性載入實作指南：ReflectionClass 與 SPL 自動載入

為何需要惰性載入？

傳統 require_once 在腳本開頭載入所有類別檔案，隨專案增大會造成：

• 記憶體浪費：未使用的類別也被載入
• 啟動緩慢：解析大量 PHP 檔案耗時
• 維護困難：檔案依賴關係混亂

惰性載入（Lazy Loading）僅在真正需要類別時才載入，結合 ReflectionClass 與 SPL 自動載入機制，可實現優雅的按需載入。

核心原理：ReflectionClass 觸發自動載入

<?php
// test.php
class Test {
    public function showName() {
        var_dump(__CLASS__);
    }
}

// index.php
var_dump(get_included_files()); // 僅含 index.php

$rf = new ReflectionClass('Test'); // 此處觸發 __autoload
var_dump(get_included_files()); // 新增 test.php

$obj = $rf->newInstance();
$obj->showName(); // 輸出 string(4) "Test"

現代寫法：spl_autoload_register

__autoload 已棄用（PHP 7.2+），應使用 spl_autoload_register 註冊多載入器：

<?php
// 自動載入器
spl_autoload_register(function ($class) {
    $file = __DIR__ . '/src/' . str_replace('\\', '/', $class) . '.php';
    if (file_exists($file)) {
        require_once $file;
        return true;
    }
    return false;
});

// 使用
$user = new App\Models\User(); // 自動載入 src/App/Models/User.php
$order = new App\Services\OrderService(); // 自動載入對應檔案

進階：單例模式整合惰性載入

<?php
class Container {
    private static $instances = [];
    private static $loaders = [];
    
    public static function registerLoader(callable $loader) {
        self::$loaders[] = $loader;
    }
    
    public static function get(string $class) {
        if (!isset(self::$instances[$class])) {
            // 嘗試自動載入
            foreach (self::$loaders as $loader) {
                if ($loader($class)) break;
            }
            if (!class_exists($class)) {
                throw new RuntimeException("Class $class not found");
            }
            // 建立單例
            $ref = new ReflectionClass($class);
            self::$instances[$class] = $ref->newInstanceWithoutConstructor();
            // 若有初始化方法
            if (method_exists(self::$instances[$class], 'init')) {
                self::$instances[$class]->init();
            }
        }
        return self::$instances[$class];
    }
}

// 註冊 PSR-4 載入器
Container::registerLoader(function($class) {
    $file = __DIR__ . '/' . str_replace('\\', '/', $class) . '.php';
    if (file_exists($file)) {
        require_once $file;
        return true;
    }
    return false;
});

// 使用
$db = Container::get('App\Database\Connection');
$cache = Container::get('App\Cache\RedisCache');

Composer PSR-4 標準：生產環境首選

手寫自動載入僅適合學習或微型專案。正式專案請直接使用 Composer：

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

執行 composer dump-autoload 產生 vendor/autoload.php，專案入口僅需 require 'vendor/autoload.php'; 即可享受高效能、標準化的自動載入。

效能比較

常見坑點

1. 大小寫敏感：Linux 區分大小寫，類別名稱、命名空間、檔案名稱必須完全一致。
2. 循環依賴：A 載入 B，B 又載入 A，導致死循環。解決：重構架構、使用介面、延遲初始化。
3. 效能陷阱：自動載入器內避免複雜邏輯、I/O 操作，單純 file_exists + require 最快。
4. 開發 vs 正式環境：開發環境關閉 OpCache 快取以即時生效；正式環境開啟 OpCache + Composer Classmap 快取極致效能。

總結

理解 ReflectionClass 觸發自動載入的機制，有助於深入掌握 PHP 類別載入流程。但實務上，**請直接使用 Composer PSR-4**，專注於業務邏輯而非重造輪子。