自動載入讓開發者無需手動 include/require 每個類別檔案。PHP 5 引入 __autoload(),5.1.2+ 推薦 spl_autoload_register(),現代框架遵循 PSR-4 標準由 Composer 產生載入器。
| 版本 | 機制 | 特點 |
|---|---|---|
| PHP 5.0 | __autoload() | 全域單一函數,無法多載入器共存 |
| PHP 5.1.2 | spl_autoload_register() | 支援多載入器堆疊、優先順序、匿名函數 |
| PHP 5.3 | 命名空間 + PSR-0 | 目錄結構對應命名空間 |
| PHP 5.4+ | PSR-4 (Composer) | 更靈活的前綴對應、效能優化、ClassMap |
<?php
function __autoload(string $className): void {
$file = __DIR__ . '/classes/' . str_replace('\\', '/', $className) . '.php';
if (file_exists($file)) {
require_once $file;
}
}
new App\Models\User(); // 觸發 __autoload('App\Models\User')
?>
<?php
// 1. 註冊多個載入器 (優先順序:先註冊先嘗試)
spl_autoload_register(function ($class) {
$file = __DIR__ . '/src/' . str_replace('\\', '/', $class) . '.php';
if (file_exists($file)) require_once $file;
});
spl_autoload_register(function ($class) {
$file = __DIR__ . '/lib/' . str_replace('\\', '/', $class) . '.php';
if (file_exists($file)) require_once $file;
});
// 2. 類別靜態方法作為載入器
class Loader {
public static function load(string $class): bool {
$file = __DIR__ . '/' . str_replace('\\', '/', $class) . '.php';
if (file_exists($file)) {
require_once $file;
return true;
}
return false;
}
}
spl_autoload_register([Loader::class, 'load']);
// 3. 查看已註冊載入器
print_r(spl_autoload_functions());
// 4. 移除載入器
spl_autoload_unregister([Loader::class, 'load']);
?>
new ClassName()、implements、extends、instanceof、class_exists() 等需解析類別時。zend_fetch_class() → zend_lookup_class_ex()。spl_autoload_register 註冊函數 → 依序呼叫 (第二參數傳入 zend_call_function)。__autoload → 呼叫 __autoload (第一參數)。Error: Class not found。<?php
function __autoload($class) { echo "__autoload: $class\n"; }
function splLoader($class) { echo "SPL: $class\n"; }
spl_autoload_register('splLoader');
new NonExistentClass();
// 輸出:
// SPL: NonExistentClass
// __autoload 不會被呼叫!
?>
結論: 只要註冊了 SPL 載入器,__autoload 就完全不會被呼叫。SPL 機制優先級更高且支援堆疊。
// composer.json
{
"autoload": {
"psr-4": {
"App\\": "src/",
"Vendor\\Package\\": "packages/package/src/"
},
"classmap": ["legacy/"], // 不符合 PSR-4 的舊代碼
"files": ["helpers.php"] # 全域函數檔
}
}
// 執行 composer dump-autoload 產生 vendor/autoload.php
// 專案入口只需:
require_once __DIR__ . '/vendor/autoload.php';
// 即可使用:
use App\Controllers\UserController;
use Vendor\Package\Service;
?>
class => file 對應表,載入時 O(1) 查找,避免 file_exists 系統呼叫。opcache.enable_cli=1 + opcache.preload (PHP 7.4+)。new $className() 無法被靜態分析與預載入。