不用 spl_autoload_register 的專案,每個檔案開頭都會堆著一串 require_once,新增一個類別就得回頭補一行。本文示範如何用「集中註冊表 + 自動載入函式」把這件事收束起來。
專案目錄結構如下:

<?php
final class Utils {
private function __construct() {
}
public static function getClasses($pre_path = '/') {
$classes = array(
'DBConfig' => $pre_path . 'DBConfig/DBConfig.php',
'User' => $pre_path . 'Model/User.php',
'Dao' => $pre_path . 'Dao/Dao.php',
'UserDao' => $pre_path . 'Dao/UserDao.php',
'UserMapper' => $pre_path . 'Mapping/UserMapper.php',
);
return $classes;
}
}
?>
用 final 加上私有建構子,讓 Utils 只能作為靜態工具類使用,不能被繼承也不會被 new。這張對照表就是整個自動載入機制的資料來源:類別名稱 → 檔案路徑。
注意:步驟一中的路徑是相對於 init.php 而言的,不是相對於 Utils.php。因為實際執行 require 的是 init.php 裡註冊的那個載入函式,相對路徑的基準點由它決定。這一點搞錯,就會出現明明檔案存在卻找不到的怪現象。
<?php
require_once '/Utils/Utils.php';
final class Init {
/**
* 系統設定
*/
public function init() {
// 開發階段開啟全部錯誤與嚴格標準
error_reporting(E_ALL | E_STRICT);
mb_internal_encoding('UTF-8');
// 註冊類別自動載入
spl_autoload_register(array($this, 'loadClass'));
}
/**
* 類別載入器
*/
public function loadClass($name) {
$classes = Utils::getClasses();
if (!array_key_exists($name, $classes)) {
die('Class "' . $name . '" not found.');
}
require_once $classes[$name];
}
}
$init = new Init();
$init->init();
?>
<?php
require_once 'Init.php';
$dao = new UserDao();
$result = $dao->findByName('zcl');
?>
這裡完全沒有 require UserDao.php。當 PHP 執行到 new UserDao() 時,發現類別尚未定義,便回頭呼叫註冊過的載入函式,把 UserDao 這個名稱傳進去,由它查表並引入對應檔案。類別定義好之後,程式繼續執行。
好處是集中管理。所有類別與檔案的對應關係寫在一處,一眼就能看出專案有哪些類別;新增類別時改一個陣列即可,不必回頭修改各個呼叫點。
缺點是維護成本會隨專案膨脹。每加一個類別都得回來改 getClasses(),幾十個之後這張表本身就成了負擔,而且很容易漏。
因此 PHP 5.3 之後引進了 namespace,配合 PSR-4 自動載入規範,可以完全擺脫這張對照表:只要檔案路徑與 namespace 的對應關係符合約定,載入器就能直接推導出檔案位置。Composer 的 autoload 設定就是這樣運作的,實作上只需要一行:
spl_autoload_register(function ($class) {
$file = __DIR__ . '/src/' . str_replace('\\', '/', $class) . '.php';
if (is_file($file)) {
require $file;
}
});
本文這套手寫方案的價值在於理解原理——知道「類別自動載入」背後其實就是一個查表或路徑推導的函式,在沒有 Composer 的環境中也能自己實作;而在現代專案裡,直接用 Composer 的 PSR-4 自動載入會省事得多。
另外提醒一點:die() 不是好的錯誤處理方式,它會直接終止整個請求且無法被上層攔截。實務上應該 throw new \Exception("Class {$name} not found"),讓呼叫端決定如何處理。