SPL(Standard PHP Library)提供了標準化的自動載入機制,取代傳統單一 `__autoload()`。本文深入剖析 `spl_autoload`、`spl_autoload_register`、`spl_autoload_call` 三大核心函式的運作原理、鏈式調用機制與最佳實踐。
<?php
// 1. 設定類檔搜尋路徑
set_include_path(get_include_path() . PATH_SEPARATOR . '/path/to/lib' . DIRECTORY_SEPARATOR);
// 2. 可選:自訂副檔名
spl_autoload_extensions('.php,.class.php,.inc');
// 3. 註冊預設載入器(等同 spl_autoload_register('spl_autoload'))
spl_autoload_register();
// 現在可直接 new ClassName,自動在 include_path 尋找 classname.php
?>
<?php
class Psr4Autoloader
{
private array $prefixes = [];
public function addNamespace(string $prefix, string $baseDir): void
{
$prefix = trim($prefix, '\\') . '\\';
$baseDir = rtrim($baseDir, DIRECTORY_SEPARATOR) . DIRECTORY_SEPARATOR;
$this->prefixes[$prefix][] = $baseDir;
}
public function loadClass(string $class): void
{
foreach ($this->prefixes as $prefix => $dirs) {
if (str_starts_with($class, $prefix)) {
$relative = substr($class, strlen($prefix));
$file = str_replace('\\', DIRECTORY_SEPARATOR, $relative) . '.php';
foreach ($dirs as $dir) {
$full = $dir . $file;
if (file_exists($full)) {
require $full;
return;
}
}
}
}
}
}
// 註冊
$loader = new Psr4Autoloader();
$loader->addNamespace('App', __DIR__ . '/src');
$loader->addNamespace('Vendor\\Package', __DIR__ . '/vendor/package/src');
spl_autoload_register([$loader, 'loadClass']);
// Composer 自動生成的 autoload_psr4.php 即是此原理
?>
<?php
// 註冊順序決定優先級:先註冊先嘗試
spl_autoload_register('legacy_autoloader'); // 舊專案兼容
spl_autoload_register([$psr4Loader, 'loadClass']); // 新專案 PSR-4
spl_autoload_register('fallback_autoloader'); // 最後兜底
// 可指定優先級(PHP 8.0+)
spl_autoload_register($callable, true, true); // prepend = true 插到最前
?>
| 坑點 | 原因 | 解決 |
|---|---|---|
| 大小寫不匹配 | `spl_autoload` 將類名轉小寫,Linux 區分大小寫 | 檔名統一小寫,或用 PSR-4 自訂載入器保持原大小寫 |
| 命名空間分隔符 | Windows 不區分 `\` `/`,Linux 嚴格 | `str_replace('\\', DIRECTORY_SEPARATOR, $class)` |
| 重複載入 | 多載入器皆匹配同一類 | 載入器內 `if (class_exists($class, false)) return;` |
| 異常吞沒 | `spl_autoload_call` 捕獲所有異常並靜默失敗 | 載入器內自行 try-catch 並記錄日誌,或改用 Composer 自動載入 |
| 效能 | 大量 `file_exists` 系統調用 | 生產環境用 Composer `classmap` / `opcache.preload` |
掌握 SPL 自動載入鏈機制,能看懂 Composer 原理、排查類找不到問題、設計高擴展性的模組系統。