Windows 下 PHP PEAR 安裝全攻略：從 go-pear.phar 到離線部署

Windows 下 PHP PEAR 安裝全攻略：從 go-pear.phar 到離線部署

PEAR (PHP Extension and Application Repository) 是 PHP 官方擴展庫管理器，雖然 Composer 已成為主流，但維護舊項目、安裝 PHPUnit 3.x 等舊版工具仍需 PEAR。本文提供最簡安裝路徑及常見問題解決方案。

最簡安裝三步走

1. 下載：獲取 go-pear.phar 至 PHP 目錄（如 E:\php）
2. 運行：以管理員權限打開 CMD，執行 php go-pear.phar
3. 確認：全程回車接受默認配置，完成後雙擊生成的 PEAR_ENV.reg 導入環境變量

驗證安裝

pear version
# 輸出示例：PEAR Version: 1.10.13, PHP Version: 7.4.30

核心配置文件修改

安裝完成後必須修改 php.ini 的 include_path：

; Windows 示例
include_path = ".;C:\php\pear"

重啟 Apache/Nginx 或 PHP-FPM 生效。

PEAR 常用命令速查

離線安裝包實戰

1. 從 官網 下載 .tgz 包
2. 放入 C:\php\pear\go-pear-bundle 目錄
3. 執行 pear install package.tgz

常見坑點與解決

• UAC 權限：必須以管理員運行 CMD，否則無法寫入系統目錄
• SSL 錯誤：啟用 php_openssl.dll，確保 allow_url_fopen=On
• 代理環境：設置 pear config-set http_proxy https://proxy:port
• 版本衝突：不同項目需不同 PEAR 版本時，建議改用 Composer 管理項目級依賴

官方資源鏈接

• 安裝指南：https://pear.php.net/manual/en/installation.getting.php
• 包瀏覽：https://pear.php.net/packages.php

PEAR 見證了 PHP 生態早期發展，雖逐漸退出歷史舞台，但了解其工作原理有助於理解現代包管理器的設計思想。