PHP SPL 標準庫自動加載機制：spl_autoload_register 替代 __autoload

PHP SPL 標準庫自動加載機制：spl_autoload_register 替代 __autoload

PHP 5.1+ 引入 SPL（Standard PHP Library），提供 spl_autoload_register() 替代傳統 __autoload()，支持多自動加載函數棧，解決類庫衝突，是現代框架（Laravel、Symfony、ThinkPHP 等）的標準做法。

傳統 __autoload 缺陷

function __autoload($classname) {
    if (is_file($classname . '.php')) include $classname . '.php';
    elseif (is_file($classname . '.inc')) include $classname . '.inc';
}

• 全局只能存在一個 __autoload，引入第三方庫時極易衝突。
• 無法優先級控制，調試困難。

SPL 自動加載三步走

1. 註冊擴展名（可選）：spl_autoload_extensions('.php,.inc,.class.php');
2. 設置搜索路徑：set_include_path(get_include_path() . PATH_SEPARATOR . '/path/to/lib' . DIRECTORY_SEPARATOR);
3. 註冊自動加載器：spl_autoload_register(); // 使用內置 spl_autoload
   或註冊自定義函數：spl_autoload_register('myAutoloader');

自定義加載器示例

function myAutoloader($class) {
    // PSR-4 風格：命名空間映射目錄
    $prefix = 'App\\';
    if (strncmp($class, $prefix, strlen($prefix)) !== 0) return;
    $relative = substr($class, strlen($prefix));
    $file = __DIR__ . '/src/' . str_replace('\\', '/', $relative) . '.php';
    if (is_file($file)) require $file;
}
spl_autoload_register('myAutoloader');

常見問題解答

• __autoload 與 spl_autoload_register 能共存嗎？：可以，但 __autoload 會在 SPL 棧之前執行，建議完全遷移到 SPL。
• 如何註銷已註冊的加載器？：spl_autoload_unregister('myAutoloader');
• PHP 8.0+ 是否仍建議使用？：依然推薦，但配合 Composer 自動生成的 vendor/autoload.php（內部即使用 SPL）更為標準。