SPL (Standard PHP Library) 是 PHP 5 引入的標準擴展庫,提供:自動加載機制、迭代器接口/類、數據結構(堆、棧、隊列、雙向鏈表)、文件處理、異常類等。本文聚焦自動加載核心 spl_autoload_register()。
__autoload 到 spl_autoload_register__autoload()function __autoload($class) {
$file = $class . '.php';
if (is_file($file)) require_once $file;
}
$obj = new MyClass(); // 觸發 __autoload('MyClass')
缺陷: 全局只能定義一個,無法組合多個加載規則(如框架核心、第三方庫、項目業務各自規則)。
spl_autoload_register() 堆棧機制bool spl_autoload_register(callable $autoload_function = null, bool $throw = true, bool $prepend = false)
spl_autoload()(按 include_path 查找 類名.php/.inc)。__autoload 會被 spl_autoload() 或 spl_autoload_call() 替換,舊 __autoload 失效,**必須顯式註冊**才能繼續工作。function myLoader($class) {
$file = __DIR__ . '/src/' . str_replace('\\', '/', $class) . '.php';
if (is_file($file)) require_once $file;
}
spl_autoload_register('myLoader');
class Loader {
public static function loadClass($class) {
$file = __DIR__ . '/src/' . str_replace('\\', '/', $class) . '.php';
if (is_file($file)) require_once $file;
}
}
spl_autoload_register(['Loader', 'loadClass']);
// 或 PHP 5.4+ 簡寫
spl_autoload_register('Loader::loadClass');
spl_autoload_register(function ($class) {
$file = __DIR__ . '/src/' . str_replace('\\', '/', $class) . '.php';
if (is_file($file)) require_once $file;
});
// 1. Composer 風格:命名空間前綴映射到目錄
spl_autoload_register(function ($class) {
$prefix = 'App\\';
$baseDir = __DIR__ . '/app/';
if (strncmp($class, $prefix, strlen($prefix)) !== 0) return;
$file = $baseDir . str_replace('\\', '/', substr($class, strlen($prefix))) . '.php';
if (is_file($file)) require_once $file;
});
// 2. 第三方庫映射
spl_autoload_register(function ($class) {
$prefix = 'Vendor\\Package\\';
$baseDir = __DIR__ . '/vendor/package/src/';
if (strncmp($class, $prefix, strlen($prefix)) !== 0) return;
$file = $baseDir . str_replace('\\', '/', substr($class, strlen($prefix))) . '.php';
if (is_file($file)) require_once $file;
});
現代 PHP 項目**不應手寫自動加載器**,而應使用 Composer 生成的 vendor/autoload.php,它完美實現了 PSR-4 標準,支持:
composer dump-autoload -o)# 僅需在入口文件引入一次
require_once __DIR__ . '/vendor/autoload.php';
// 之後直接使用任何已安裝包的類
use App\Controller\UserController;
use Vendor\Package\Service;
print_r(spl_autoload_functions());spl_autoload_unregister('myLoader');spl_autoload_call('MyClass');spl_autoload_register 通過堆棧機制解決了多加載規則共存問題,是現代 PHP 自動加載的基石。理解其原理有助於排查類找不到、重複加載、順序衝突等疑難雜症,但**生產項目請直接使用 Composer 自動生成的加載器**,專注業務開發。