什麼是 PEAR？
PEAR (PHP Extension and Application Repository) 是 PHP 官方維護的代碼庫，提供大量可復用的 PHP 組件（如 MDB2、Mail、HTTP_Request2 等），類比 Perl 的 CPAN、Python 的 PyPI、Node 的 npm。
Windows 環境安裝步驟
1. 獲取 go-pear.phar
PHP 5.3+ 版本自帶的 go-pear.php 可能過舊報錯，建議下載最新 go-pear.phar：
# 放到 PHP 安裝目錄，如 D:\php
curl -o go-pear.phar https://pear.php.net/go-pear.phar
2. 以管理員身份運行安裝
cd D:\php
php go-pear.phar
提示選擇：
Are you installing a system-wide PEAR or a local copy? (system|local) [system] : local
Please confirm local copy by typing 'yes' : yes
選擇 local 避免寫入系統目錄 (C:\Windows) 權限問題。
3. 確認目錄佈局 (直接回車用默認)
1. Installation base ($prefix) : D:\php
2. Temporary directory for processing : D:\php\tmp
...
11. Name of configuration file : D:\php\pear.ini
12. Path to CLI php.exe : D:\php
1-12, 'all' or Enter to continue:
4. 更新 php.ini 包含路徑
Would you like to alter php.ini ? [Y/n] : Y
php.ini include_path updated. Current include path: .;D:\php\pear
5. 驗證安裝
pear version
# 輸出類似：PEAR Version: 1.10.13, PHP Version: 7.4.33
Linux (CentOS/Ubuntu) 安裝
# 1. 安裝 pear 套件管理器
yum install php-pear # CentOS
apt install php-pear # Ubuntu
# 2. 升級 pear 自身
pear upgrade PEAR
# 3. 設置自動發現通道
pear config-set auto_discover 1
安裝 PEAR 套件示例
# 安裝 MDB2 數據庫抽象層
pear install MDB2
# 安裝 Mail 發郵件組件
pear install Mail Mail_Mime
# 指定版本
pear install Net_SMTP-1.8.0
# 列出已安裝
pear list
常見錯誤與解決
| 錯誤現象 | 原因 | 解決 |
|---|
Warning: require_once(Structures/Graph.php): failed to open stream | 依賴包 Structures_Graph 缺失 | pear install Structures_Graph 或手動下載解壓到 pear 目錄 |
ERROR: failed to mkdir C:\php\pear\docs\... | 權限不足 | 以管理員運行 CMD / 選擇 local 安裝 |
Deprecated: Assigning the return value of new by reference is deprecated | go-pear.php 過舊不兼容 PHP 5.3+ | 使用 go-pear.phar |
No releases available for package "xxx" | 通道未更新/名稱錯誤 | pear clear-cache; pear update-channels |
現代替代方案：Composer
PEAR 目前維護緩慢，生態已被 Composer (Packagist) 取代。新項目強烈建議：
composer require pear/mdb2
composer require pear/mail
# 絕大多數 PEAR 包已遷移至 Packagist，前綴 pear/
總結
PEAR 是 PHP 早期標準化組件分發的重要基礎設施。Windows 下安裝關鍵在於 下載 go-pear.phar + 選擇 local + 管理員權限。現代開發請直接使用 Composer，享受更豐富的生態、語義化版本控制、自動加載等優勢。
