PHP 自動加載機制演進：從 __autoload 到 PSR-4 與 Composer 最佳實踐

為什麼需要自動加載？

早期 require_once 'Class.php' 模式痛點：

• 文件多時引入語句爆炸，維護地獄。
• 易漏引、重複引、順序依賴。
• 無法按需加載，浪費內存與 IO。

自動加載 = 按需、延遲、約定式 載入類文件。

三代自動加載機制對比

核心 API：spl_autoload_register 詳解

<?php
// 1. 注冊匿名函數加載器（簡單項目）
spl_autoload_register(function ($class) {
    $file = __DIR__ . '/src/' . str_replace('\\', '/', $class) . '.php';
    if (is_file($file)) require $file;
});

// 2. 注冊類靜態方法（模塊化）
class MyLoader {
    public static function load(string $class): void {
        // 映射邏輯...
    }
}
spl_autoload_register([MyLoader::class, 'load']);

// 3. 優先級控制（預加載、覆蓋）
spl_autoload_register($loader, true, true); // $prepend=true 放棲頂

// 4. 異常處理：找不到類拋出 Exception 而非 Fatal Error
spl_autoload_register(function ($class) {
    throw new Exception("Class $class not found");
});

PSR-4 標準：命名空間 → 文件路徑映射規則

完全限定類名：\Vendor\Package\SubNamespace\ClassName
                      │           │
                      └─ 命名空間前綴 ─┘  ← 映射到基礎目錄
                                    │
                                    └─ 相對路徑：SubNamespace/ClassName.php

規則：

1. 命名空間前綴對應一個基礎目錄。
2. 後續子命名空間對應子目錄，\ 轉 /。
3. 類名即文件名（.php），大小寫敏感。

Composer 自動加載：零配置享受 PSR-4

composer.json

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

生成與使用

composer dump-autoload -o  # 生成優化加載器（生產環境）
# 入口文件
require __DIR__ . '/vendor/autoload.php';

use App\Controller\UserController;
$ctrl = new UserController(); // 自動載入 src/Controller/UserController.php

Composer 加載器優化細節

• Class Map：dump-autoload -o 生成 class -> file 映射表，無需文件系統查找，極快。
• APCu Cache：composer dump-autoload --apcu 將映射存 APCu，跨進程共享。
• Preloading (PHP 7.4+)：opcache.preload=preload.php 啟動時預載入熱門類，彌補無 JIT 的啟動開銷。

避坑指南

1. 大小寫敏感：Linux 區分大小寫，類名/文件名必須精確匹配（PSR-4 要求 StudlyCaps）。
2. 不要手動 require vendor/autoload.php 以外的文件，破壞自動加載邏輯。
3. 命名空間前綴唯一：避免 App\\ 映射到多個目錄，導致衝突。
4. 生產環境必須 -o 優化，開發環境可不加以便即時生效。

總結

現代 PHP 專案：composer.json 配置 psr-4 → dump-autoload -o → require vendor/autoload.php。忘掉 __autoload、手寫 spl_autoload_register，拥抱生態標準，專注業務邏輯。