PEAR 入門指南：標準化 PHP 代碼、復用套件、框架基類 (PEAR.php、PEAR_Error)

什麼是 PEAR

**PHP Extension and Application Repository** — PHP 官方套件庫，類比 Perl CPAN。提供：

• 分類管理的套件庫 (DB, HTML, Cache, XML, Mail…)。
• 統一編碼標準 (縮排、命名、註釋、檔案結構)。
• 兩個核心基類：`PEAR` (通用基類)、`PEAR_Error` (錯誤處理)。

為何使用 PEAR

1. **代碼復用**：標準化介面，直接 `require_once 'Package/Name.php'` 使用社區成熟套件。
2. **團隊協作**：統一風格減少認知負擔，Code Review 專注邏輯而非格式。
3. **框架基礎**：`PEAR` 類模擬解構函數 (`register_shutdown_function`)、錯誤堆疊、靜態屬性單例模式，早期框架 (如早期 Symfony、Zend Framework 1) 均以此為基石。

核心編碼規範 (摘要)

快速上手：建立符合 PEAR 規範的類

<?php
// File: Net/MyService.php
require_once 'PEAR.php';

class Net_MyService extends PEAR {
    public function __construct($options = []) {
        parent::__construct(); // 註冊 shutdown 解構
        $this->_options = $options;
    }

    public function callApi($endpoint, $data) {
        // 邏輯...
        if ($error) {
            return $this->raiseError('API call failed', 500); // 回傳 PEAR_Error
        }
        return $result;
    }

    // 解構函數模擬 (PHP 4/5 早期無 __destruct)
    public function _Net_MyService() {
        // 清理資源
    }
}

// 使用
$svc = new Net_MyService(['timeout'=>10]);
$result = $svc->callApi('/users', ['id'=>1]);
if (PEAR::isError($result)) {
    die($result->getMessage());
}

PEAR 套件管理器 (安裝/更新/依賴)

# 安裝 pear 套件管理器 (通常隨 PHP 安裝)
# Linux: apt install php-pear / yum install php-pear
# Windows: go-pear.phar

# 安裝套件
pear install DB
pear install HTML_QuickForm2

# 列出已安裝
pear list

# 更新通道
pear channel-update pear.php.net

現代替代方案

• Composer + Packagist：已成主流，支援語義化版本、自動載入、依賴解析，**強烈建議新專案使用**。
• PEAR 套件多已遷移至 Packagist (如 `pear/DB` → `pear/db`)。
• 維護舊專案時仍需了解 PEAR 規範與 `PEAR_Error` 錯誤處理模式。