PHP 自動加載機制完全指南：從 __autoload 到 PSR-4 與 Composer 現代標準

自動加載是現代 PHP 組件化、框架化開發的基石。本文梳理從早期 __autoload 到 SPL spl_autoload_register、PSR-0/PSR-4 標準、Composer 生態的演進脈絡。

歷史演進

手寫 PSR-4 加載器（教學用）

class Psr4Loader {
    private $prefixes = []; // 前綴 => 基礎目錄[]
    
    public function addPrefix(string $prefix, string $baseDir): void {
        $prefix = trim($prefix, '\\') . '\\';
        $baseDir = rtrim($baseDir, '/\\') . '/';
        $this->prefixes[$prefix][] = $baseDir;
    }
    
    public function register(): void {
        spl_autoload_register([$this, 'loadClass']);
    }
    
    public function loadClass(string $class): void {
        foreach ($this->prefixes as $prefix => $dirs) {
            if (strncmp($class, $prefix, strlen($prefix)) !== 0) continue;
            $relativeClass = substr($class, strlen($prefix));
            $fileName = str_replace('\\', '/', $relativeClass) . '.php';
            foreach ($dirs as $dir) {
                $file = $dir . $fileName;
                if (is_file($file)) {
                    require $file;
                    return;
                }
            }
        }
    }
}

// 使用
$loader = new Psr4Loader();
$loader->addPrefix('App', __DIR__ . '/src');
$loader->addPrefix('Vendor\Package', __DIR__ . '/vendor/package/src');
$loader->register();

Composer 實戰：零配置自動加載

// composer.json
{
    "autoload": {
        "psr-4": {
            "App\\": "src/",
            "App\\Tests\\": "tests/"
        },
        "files": ["src/helpers.php"] // 全局函數文件
    },
    "autoload-dev": {
        "psr-4": { "App\\Tests\\": "tests/" }
    }
}

執行 composer dump-autoload -o 生成優化加載器（類映射表），生產環境必用 -o。

生產環境優化清單

• 類映射優化：composer dump-autoload -o --classmap-authoritative，避免文件系統查找，直接內存映射。
• OPcache 預加載：PHP 7.4+ opcache.preload=preload.php，將核心類常駐內存。
• 避免 require_once：Composer 加載器內部已處理重複加載，手動 require 反而增加開銷。
• 生產環境禁用開發依賴：composer install --no-dev --optimize-autoloader。

常見問題排查

現代鐵律：項目啟動即 require __DIR__.'/vendor/autoload.php';，其餘交給 Composer + PSR-4。手寫加載器僅用於理解原理或極簡無依賴項目。