PEAR 核心概念速覽：套件庫、編碼標準、基類框架 (與 151434 互補)

PEAR 三大支柱

1. 套件庫：分類目錄結構 (`Net/`, `DB/`, `HTML/`, `Cache/`, `XML/`…)，每個套件含 `package.xml` 描述相依、版本、檔案列表。
2. 編碼標準：統一縮排、命名、註釋、引入方式，降低團隊溝通成本。
3. 基類框架：`PEAR` (通用基類)、`PEAR_Error` (錯誤物件)，提供解構模擬、錯誤堆疊、靜態單例等早期框架能力。

常用核心套件速查 (PHP 4/5 早期主流)

PEAR_Error 進階用法

class MyPackage extends PEAR {
    public function doSomething() {
        if ($fail) {
            // 回傳錯誤物件，不拋例外 (PHP 4 風格)
            return $this->raiseError(
                'Database connection failed', // 訊息
                500,                          // 代碼
                PEAR_ERROR_CALLBACK,          // 模式: 回調
                'myErrorHandler',             // 回調函數
                ['host'=>'db', 'user'=>'app'] // 額外資料
            );
        }
        return true;
    }
}

function myErrorHandler($err) {
    error_log("[MyPackage] {$err->getMessage()} (Code: {$err->getCode()})");
    // 可發送郵件、寫入監控系統
}

$result = $pkg->doSomething();
if (PEAR::isError($result)) {
    // 錯誤已由回調處理，這裡可決定是否繼續
}

遷移到 Composer 的對照表

總結

PEAR 是 PHP 早期標準化的里程碑，雖已由 Composer 取代，但其**編碼規範、套件分類思想、錯誤處理模式**深刻影響現代 PHP 生態。維護舊專案時理解 PEAR 機制仍不可或缺。