PEAR 入門教程 (一)：核心概念與安裝部署

什麼是 PEAR？

PEAR (PHP Extension and Application Repository) 是 PHP 官方維護的開源程式碼庫與套件管理系統，發音同 "梨"。它提供：

• 結構化、可復用的 PHP 元件庫 (超過 600 個套件)
• 統一的套件發布、版本控制與相依性解析機制
• PHP 程式碼風格標準 (PSR 前身)
• PECL (C 擴展庫) 的姊妹專案

適用場景與前置條件

• 已能搭建 WAMP/LAMP 環境
• 具備基礎 PHP 語法能力
• 需要快速整合成熟元件 (資料庫抽象、表單驗證、快取、郵件、日誌等)

核心機制：include_path 與自動載入

PEAR 套件安裝後實際只是一組 PHP 類別檔案，關鍵在於讓 PHP 能找到它們。兩種方式：

1. 修改 php.ini (全域生效)

; Windows
include_path = ".;C:\php\pear;C:\myproject\lib"

; Linux/Unix
include_path = ".:/usr/share/php:/var/www/myproject/lib"

2. 運行時動態設定 (推薦，專案隔離)

<?php
// PHP 4.3.0+ 推薦
set_include_path(
    '/path/to/pear/lib' . PATH_SEPARATOR . get_include_path()
);

// 或僅在需要時
ini_set('include_path', '/path/to/pear/lib' . PATH_SEPARATOR . ini_get('include_path'));
?>

手動安裝步驟 (無 root 權限/虛擬主機適用)

1. 專案根目錄建立 lib/pear 目錄。
2. 下載 PEAR 套件 (或最新版)，解壓至 lib/pear。
3. 建立引導檔 bootstrap.php：

<?php
define('PEAR_DIR', __DIR__ . '/lib/pear');
set_include_path(PEAR_DIR . PATH_SEPARATOR . get_include_path());
require_once 'PEAR.php'; // 核心類
?>

4. 在專案入口檔 require_once 'bootstrap.php'; 即可使用 require_once 'DB.php'; 等標準 PEAR 套件。

使用 PEAR 套件管理器 (有 shell 權限時)

# 安裝 pear 指令
wget https://pear.php.net/go-pear.phar
php go-pear.phar

# 之後即可
pear install DB
pear install Cache_Lite
pear list
pear upgrade-all

驗證安裝

<?php
require_once 'bootstrap.php';
require_once 'System.php'; // PEAR 核心套件
echo 'PEAR 版本: ' . PEAR::getVersion() . "\n";
echo 'include_path: ' . get_include_path() . "\n";
?>

輸出版本資訊即代表安裝成功。

下一步預告

下一篇將深入 Cache_Lite 快取套件，示範頁面片段快取、資料物件快取與自動清理策略，助你輕鬆提升網站回應速度。