在無系統權限環境下創建本地 PEAR 庫

當無法修改系統級 PEAR 安裝時（如共享主機），可在用戶目錄下構建獨立的 PEAR 環境，實現包的自主管理與使用。

操作步驟

1. 創建配置文件

$ pear config-create $HOME .pearrc

若報錯，需手動設置臨時目錄：

$ pear config-set download_dir /home/用戶名/tmp/pear/cache
$ pear config-set cache_dir /home/用戶名/tmp/pear/cache
$ pear config-set temp_dir /home/用戶名/tmp/pear/temp

2. 安裝 PEAR 核心包

$ pear install -o PEAR

-o 參數會連同依賴包一併安裝。

3. 安裝所需擴展包

$ pear install pear/包名

4. 在 PHP 代碼中引入本地 PEAR

PHP 4：

ini_set(
    'include_path',
    ini_get('include_path') . PATH_SEPARATOR . "/home/用戶名/pear/php"
);

PHP 5+：

set_include_path(
    get_include_path() . PATH_SEPARATOR . '/home/用戶名/pear/php'
);

原理說明

• config-create 生成的 .pearrc 定義了本地安裝路徑、臨時目錄等
• 所有包安裝至 $HOME/pear/ 目錄結構中
• 通過修改 include_path 使腳本能找到本地類庫

優勢

1. 不需要 root 權限
2. 項目間環境隔離，版本衝突風險為零
3. 便於版本控制與部署遷移
4. 可精確控制依賴版本

此方法在虛擬主機、容器環境、CI/CD 流程中極具實用價值，是 PHP 依賴管理的重要補充手段。