DIV CSS 佈局教程網

解析 PHP 類別的註冊與自動載入機制
編輯:關於JavaScript     

不用 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();
?>

步驟三:使用處只需引入 init.php

<?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"),讓呼叫端決定如何處理。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved