Windows 下 PHP 安裝 PEAR 完整教程 (無 go-pear.bat 解決方案)

前言

PEAR (PHP Extension and Application Repository) 是 PHP 官方擴展庫管理工具。新版 PHP Windows 包常不含 go-pear.bat，本文提供通用安裝方案。

一、下載安裝腳本

# 1. 下載 go-pear.phar (官方最新版)
# PowerShell
Invoke-WebRequest -Uri "https://pear.php.net/go-pear.phar" -OutFile "C:\php\go-pear.phar"

# 或瀏覽器下載: https://pear.php.net/go-pear.phar
# 建議放在 PHP 目錄 (如 C:\php)

二、以管理員權限執行安裝

# 1. 以管理員身份打開 CMD/PowerShell
# 2. 切換到 PHP 目錄
cd C:\php

# 3. 執行安裝
php go-pear.phar

三、安裝向導關鍵步驟

1. 安裝類型：選擇 system (系統級) 或 local (本地)，建議 system
2. 路徑確認：顯示 12 項路徑配置，直接回車使用預設
3. php.ini 修改：腳本會提示添加 include_path，按提示操作或手動編輯 php.ini：

   include_path = ".;C:\php\pear"

4. 環境變數註冊：腳本生成 PEAR_ENV.reg，雙擊導入註冊表

四、驗證安裝

# 重新打開 CMD (繼承新環境變數)
pear version
# 輸出類似:
# PEAR Version: 1.10.13
# PHP Version: 7.4.30
# Zend Engine Version: 3.4.0

五、常用 PEAR 指令

六、安裝 PHPUnit 示例 (需 PEAR)

# 1. 升級 PEAR 自身
pear upgrade pear

# 2. 添加頻道 (網絡不穩多試幾次)
pear channel-discover components.ez.no
pear channel-discover pear.phpunit.de
pear channel-discover pear.symfony-project.com

# 3. 安裝 PHPUnit
pear install --alldeps --force pear.phpunit.de/PHPUnit

# 4. 驗證
phpunit --version

七、常見問題

1. SSL 錯誤：php.ini 啟用 extension=openssl
2. 權限不足：必須以管理員運行 CMD
3. include_path 未生效：檢查 php.ini 正確載入 (php --ini 確認)
4. 代理環境：pear config-set http_proxy https://proxy:port

總結

使用 go-pear.phar 替代缺失的 bat 腳本，配合管理員權限執行，即可在 Windows 完整部署 PEAR 環境。現代 PHP 專案多改用 Composer 管理依賴，PEAR 主要用於維護舊專案或安裝特定工具 (如 PHPUnit 老版本)。