PEAR 安裝與環境配置全攻略：include_path 設定、go-pear、Composer 共存

核心原理：include_path

PHP 尋找 `require/include` 檔案順序：

1. 腳本所在目錄 (相對路徑時)。
2. `include_path` 內目錄 (由左至右)。

PEAR 安裝本質 = **將 PEAR 目錄加入 `include_path`**。

三種配置方式

1. php.ini 全域 (永久、需重啟 PHP-FPM/Apache)

; Linux
include_path = ".:/usr/share/php:/usr/local/lib/php"
; Windows
include_path = ".;C:\php\pear;C:\php\includes"

2. 執行期動態修改 (跨專案隔離、無需重啟)

<?php
// 專案啟動檔 (如 bootstrap.php) 最頂部
set_include_path(
    '/path/to/project/pear' . PATH_SEPARATOR .
    '/path/to/shared/pear'  . PATH_SEPARATOR .
    get_include_path()
);

3. .htaccess / .user.ini (單目錄、共享主機適用)

# .htaccess (Apache + mod_php)
php_value include_path ".:/home/user/pear:/usr/share/php"

# .user.ini (PHP-FPM / CGI)
include_path = ".:/home/user/pear:/usr/share/php"

安裝 PEAR 套件管理器

Linux (系統包管理器)

apt update && apt install php-pear        # Debian/Ubuntu
yum install php-pear                      # CentOS/RHEL
dnf install php-pear                      # Fedora

Windows / 通用 (go-pear.phar)

1. 下載 go-pear.phar。
2. `php go-pear.phar` → 依提示選擇安裝目錄 (建議 `C:\php\pear`)。
3. 安裝完成會生成 `pear.bat` / `pear`，加入系統 PATH。

驗證安裝

pear version
pear config-show
pear list

PEAR 與 Composer 共存策略

常見問題排查

1. `Class 'PEAR' not found` → `include_path` 未包含 PEAR 目錄，或大小寫不符 (Linux 區分大小寫)。
2. `pear install` 失敗 `No releases available` → `pear channel-update pear.php.net` 更新頻道。
3. 權限錯誤 → `cache_dir`/`download_dir`/`temp_dir` 需寫入權限 (`pear config-set cache_dir /tmp/pear-cache`)。
4. 版本衝突 → `pear install -f Package-Version` 強制指定版本，或改用 Composer 精確鎖定。

快速測試腳本

<?php
// test_pear.php
require_once 'PEAR.php';
require_once 'Net/DNS2.php'; // 需先 pear install Net_DNS2

echo "PEAR base class loaded: " . class_exists('PEAR') . "\n";
echo "Net_DNS2 loaded: " . class_exists('Net_DNS2') . "\n";
$resolver = new Net_DNS2_Resolver();
$result = $resolver->query('google.com', 'A');
foreach ($result->answer as $rr) echo $rr->rdata . "\n";

1. 上一篇文章： PEAR Cache_Lite 實戰教學：頁面片段快取、標籤群組失效、生命周期控制
2. 下一篇文章： PEAR Auth_HTTP 實作 HTTP Basic/Digest 認證：資料庫驅動、自定義 Realm、取消提示

PHP 相關知識

《PHP 邊學邊教》第 02 章上篇：Apache 2.2 手動安裝與虛擬主機配置圖文詳解

前置必要動作：停用 IIS 關鍵提醒：若電腦已安裝 IIS，

PHP 判斷陣列是否為空的五種方法深度對比與最佳實踐

五大方法對比表 方法未初始化空陣列 []nullfals

PHP「Undefined index」Notice 根因分析與五種優雅解決方案

現象還原 開發中常見報警： Notice: Undefine

WordPress Gravatar 頭像本地緩存與代理服務器 CSS/JS 緩存更新完整指南

WordPress Gravatar 頭像本地緩存與代理服務