自動載入演進史
| 版本 | 機制 | 特點 |
| PHP 5.0 | __autoload() 函數 | 全域單一函數,無法共存多個載入器 |
| PHP 5.1.2+ | spl_autoload_register() | 支援多載入器堆疊、優先序控制、例外處理 |
| PHP 7.2+ | __autoload() 棄用 | 強制遷移至 SPL 機制 |
| PHP 8.0+ | __autoload() 移除 | 僅支援 SPL |
檔案結構範例
php_autoload/
├── func_autoload.php # __autoload() 方式
├── spl_autoload.php # spl_autoload_register() 方式
└── include/
├── aClass.php # class aClass { echo "aClass is loaded\n"; }
└── bClass.php # class bClass { echo "bClass is loaded\n"; }
方式一:傳統 __autoload()(不推薦新專案使用)
<?php
// func_autoload.php
define('EOL', PHP_SAPI === 'cli' ? PHP_EOL : '<br>');
function __autoload($className) {
$filename = __DIR__ . '/include/' . $className . '.php';
if (file_exists($filename)) {
include_once $filename;
} else {
exit("找不到類別檔案:$filename");
}
}
// 觸發自動載入
$a = new aClass();
$b = new bClass();
print_r(get_included_files());
?>
方式二:現代 spl_autoload_register()(推薦)
<?php
// spl_autoload.php
class MyLoader {
public static function autoload($className) {
$filename = __DIR__ . '/include/' . $className . '.php';
if (file_exists($filename)) {
include_once $filename;
} else {
exit("找不到類別檔案:$filename");
}
}
}
// 註冊靜態方法作為載入器
spl_autoload_register(['MyLoader', 'autoload']);
// 也可註冊匿名函數(PHP 5.3+)
spl_autoload_register(function($className) {
$file = __DIR__ . '/include/' . $className . '.php';
if (file_exists($file)) include_once $file;
});
// 觸發
$a = new aClass();
$b = new bClass();
?>
進階:PSR-4 標準自動載入器實作
<?php
class Psr4Autoloader {
private $prefixes = [];
public function addNamespace($prefix, $baseDir) {
$prefix = trim($prefix, '\\') . '\\';
$baseDir = rtrim($baseDir, DIRECTORY_SEPARATOR) . DIRECTORY_SEPARATOR;
$this->prefixes[$prefix][] = $baseDir;
}
public function register() {
spl_autoload_register([$this, 'loadClass']);
}
public function loadClass($class) {
foreach ($this->prefixes as $prefix => $dirs) {
if (strpos($class, $prefix) !== 0) continue;
$relativeClass = substr($class, strlen($prefix));
$fileName = str_replace('\\', DIRECTORY_SEPARATOR, $relativeClass) . '.php';
foreach ($dirs as $dir) {
$file = $dir . $fileName;
if (file_exists($file)) {
require_once $file;
return true;
}
}
}
return false;
}
}
// 使用
$loader = new Psr4Autoloader();
$loader->addNamespace('App', __DIR__ . '/src');
$loader->addNamespace('Vendor\\Package', __DIR__ . '/vendor/package/src');
$loader->register();
// 現在可以使用 new App\Controller\UserController();
?>
Composer 自動載入最佳實務
// composer.json
{
"autoload": {
"psr-4": {
"App\\": "src/",
"App\\Tests\\": "tests/"
},
"files": ["src/helpers.php"] // 全域函數檔
}
}
// 執行 composer dump-autoload 產生 vendor/autoload.php
// 專案入口只需:require __DIR__ . '/vendor/autoload.php';
關鍵差異比較
| 特性 | __autoload() | spl_autoload_register() |
| 多載入器支援 | ❌ 單一 | ✅ 多個,堆疊執行 |
| 優先序控制 | ❌ | ✅ prepend=true |
| 例外處理 | ❌ | ✅ 可拋出/捕捉例外 |
| 類別方法支援 | ❌ 僅函數 | ✅ 靜態方法、實例方法、閉包 |
| 命名空間友善 | 困難 | 原生支援 |
除錯技巧
<?php
// 查看已註冊的載入器
print_r(spl_autoload_functions());
// 手動觸發載入器(除錯用)
spl_autoload_call('MyClass');
// 取得已載入檔案列表
print_r(get_included_files());
?>