早期 PHP 專案:
<?php
require_once 'User.php';
require_once 'Order.php';
require_once 'Product.php';
require_once 'Database.php';
// ... 幾十個 require,維護噩夢
?>
痛點:手動管理依賴、載入順序敏感、重複載入風險、效能低 (載入未用類)。
<?php
function __autoload(string $className): void
{
$file = __DIR__ . '/classes/' . $className . '.php';
if (file_exists($file)) {
require_once $file;
}
}
// 使用
$user = new User(); // 自動觸發 __autoload('User') 載入 User.php
?>
缺陷:全局僅能定義一個,無法組合多個加載器 (如專案本身 + 第三方庫),命名衝突風險高。
**現代自動加載基石**。可註冊多個獨立加載器函數/類方法,按註冊順序嘗試載入。
<?php
// 1. 專案核心類加載器 (PSR-4 風格)
spl_autoload_register(function (string $class): void {
$prefix = 'App\\';
$baseDir = __DIR__ . '/src/';
$len = strlen($prefix);
if (strncmp($prefix, $class, $len) !== 0) return;
$relativeClass = substr($class, $len);
$file = $baseDir . str_replace('\\', '/', $relativeClass) . '.php';
if (file_exists($file)) require_once $file;
});
// 2. 第三方庫加載器 (另一個獨立前綴)
spl_autoload_register(function (string $class): void {
$prefix = 'Vendor\\Lib\\';
$baseDir = __DIR__ . '/vendor/lib/src/';
// ... 同理
});
// 3. 甚至可以註冊類方法
class Loader {
public static function load(string $class): void { /* ... */ }
}
spl_autoload_register(['Loader', 'load']);
// 移除加載器
spl_autoload_unregister(['Loader', 'load']);
?>
**PSR-4 (Autoloading Standard)** 定義:「完全合格類名」→「文件路徑」的確定性映射:
.php 文件例子:App\Controller\UserController → src/Controller/UserController.php (前綴 App\\ 對應 src/)
**Composer** 是 PHP 依賴管理器,**自動生成高度優化的 PSR-4/PSR-0/Classmap/Files 加載器**,解決所有依賴圖、版本鎖定、自動加載問題。
{
"name": "my/project",
"autoload": {
"psr-4": {
"App\\": "src/",
"App\\Tests\\": "tests/"
},
"classmap": ["legacy/"), // 無命名空間舊代碼
"files": ["helpers/functions.php"] // 全域函數檔
},
"autoload-dev": {
"psr-4": { "App\\Tests\\": "tests/" }
},
"require": {
"monolog/monolog": "^3.0",
"symfony/string": "^7.0"
}
}
composer install # 首次安裝,生成 vendor/autoload.php
composer dump-autoload # 代碼變更後重新生成 (新增類、改命名空間)
composer dump-autoload -o # 生成優化版 ClassMap (生產環境推薦,速度更快)
<?php
// public/index.php 或 bootstrap/app.php
require_once __DIR__ . '/../vendor/autoload.php';
// 現在可以直接使用任何已安裝套件或專案類
use App\Controller\UserController;
use Monolog\Logger;
use Symfony\Component\String\UnicodeString;
$controller = new UserController();
?>
vendor/autoload.php → ComposerAutoloaderInitxxx::getLoader() → 返回 Composer\Autoload\ClassLoader 實例。
核心邏輯:
$classMap[$class] → 直接 require (最快,O(1))$prefixLengthsPsr4、$prefixDirsPsr4,計算路徑 file_exists → requirespl_autoload_register 兜底-o 優化:掃描所有 PSR-4 目錄預建 ClassMap,運行時直接查 Map,**無文件系統 I/O**,大幅提升啟動速度。
| 舊代碼類型 | 遷移方案 |
|---|---|
| 無命名空間、檔案名=類名 | "classmap": ["legacy/"],Composer 掃描建立映射 |
| 偽命名空間 (下劃線分隔) | "psr-0": { "Zend_": "lib/" } (PSR-0 兼容) |
| 全域函數檔 | "files": ["helpers/global.php"] |
| 動態類名 (變量類名) | 確保類名字串符合 PSR-4,或手動 require |
composer.json 前綴/路徑對應composer dump-autoloadvendor/composer/autoload_psr4.php 映射是否正確composer dump-autoload -o (或 --classmap-authoritative 禁止回退檢查)opcache.preload (PHP 7.4+)opcache.preload 或 classmap_authoritative)。src/、tests/)composer.json autoload 區塊composer install / dump-autoload -orequire 'vendor/autoload.php'require_once、__autoload、手動 spl_autoload_register這就是 PHP 社區經過十年演進沉澱出的**工業級標準答案**。