PEAR vs PECL 徹底釐清：PHP 擴展生態的兩大支柱與現代包管理演進

前言

初學 PHP 時聽過 PEAR/PECL，卻常搞混。隨著 Composer 成為事實標準，它們的角色發生劇變。本文從歷史定位、架構差異、安裝機制、現代替代方案四個維度，徹底釐清兩者本質與現狀。

一、核心定義對比

二、歷史地位與演進

1. PEAR 黃金時代 (2000-2010)

• PHP 尚無標準自動加載、無 Composer，PEAR 是唯一的標準化組件分發體系。
• 確立了「一類一檔、PSR-0 前身」編碼規範，深度影響現代 PHP 風格。
• 核心組件：`DB` (PDO 前身)、`Mail`、`Auth`、`Log`、`Config`、`Cache`、`HTML_QuickForm`。

2. PECL 長青常綠

• 所有性能關鍵、底層系統調用、第三方 C 庫綁定 必走 PECL。
• PHP 內核擴展 (Core Extensions) 如 `pdo_mysql`、`opcache`、`json` 早期也在 PECL 孵化再併入核心。
• 現代高性能框架 (Swoole、OpenSwoole、Hyperf) 核心皆為 PECL 擴展。

3. Composer 統一江湖 (2012 至今)

• PEAR 純 PHP 包 → 全量遷移至 Packagist/Composer (如 `pear/pear`、`pear/http_request2`)。
• PECL 擴展 → 仍需 `pecl install` 或系統包管理器 (apt/yum/brew) 安裝二進制，**Composer 僅能聲明依賴** (`"ext-redis": "*"`) 無法安裝。
• PEAR 官方通道 (pear.php.net) 2021 年停止接受新包，轉為維護模式。

三、現代項目中的實際操作指南

場景 A：需要 Redis / Swoole / MongoDB 等 C 擴展

# 1. 系統包管理器 (推薦：版本鎖定、安全更新、依賴自動解決)
# Ubuntu/Debian
apt-get update && apt-get install -y php-redis php-swoole php-mongodb

# RHEL/CentOS/Rocky
dnf install -y php-pecl-redis php-pecl-swoole php-pecl-mongodb

# Alpine (Docker)
apk add --no-cache php-pecl-redis php-pecl-swoole php-pecl-mongodb

# 2. pecl 命令 (需安裝 php-pear/php-dev + 編譯工具鏈)
pecl install redis swoole mongodb
# 會提示啟用配置：echo "extension=redis.so" > /etc/php/8.x/mods-available/redis.ini
# phpenmod redis

# 3. Dockerfile 最佳實踐 (多階段構建)
FROM php:8.2-fpm AS builder
RUN apt-get update && apt-get install -y libssl-dev libcurl4-openssl-dev \
    && pecl install redis-5.3.7 swoole-5.0.3 \
    && docker-php-ext-enable redis swoole

FROM php:8.2-fpm
COPY --from=builder /usr/local/lib/php/extensions /usr/local/lib/php/extensions
COPY --from=builder /usr/local/etc/php/conf.d/docker-php-ext-*.ini /usr/local/etc/php/conf.d/

場景 B：需要純 PHP 庫 (HTTP 客戶端、模板、驗證器...)

# 忘掉 pear install，直接用 Composer
composer require guzzlehttp/guzzle symfony/mailer twig/twig webmozart/assert

# composer.json 自動記錄依賴，團隊統一 composer install

場景 C：遺舊項目仍用 PEAR 包

# 1. 將 pear 包轉為 composer 依賴 (大多已在 Packagist 有對應 fork)
composer require pear/http_request2 pear/mail_mime

# 2. 若極少數無對應包，可用 composer 安裝 pear 通道包
composer require --repository='{"type":"pear","url":"https://pear.php.net"}' pear/Net_DNS2

# 3. 完全切斷 pear 命令依賴，刪除 /usr/bin/pear

四、常見誤區澄清

1. 「PECL 是 PEAR 的一部分」 → 錯。兩者是獨立專案，共享同一基礎設施 (網站、鏡像、QA 流程)，但代碼庫、安裝工具、部署目標完全分離。
2. 「Composer 可以安裝 PECL 擴展」 → 錯。Composer 只能在 `require` 中聲明 `"ext-xxx": "*"` 供檢查，**無法編譯/安裝 .so 文件**。
3. 「PEAR 已死，不用管」 → 半對。純 PHP 包生態已遷移，但 PEAR Coding Standards 仍是 PHP_CodeSniffer 默認規範 (`phpcs --standard=PEAR`)，許多老牌庫仍遵循。
4. 「Windows 下不用 PECL」 → 錯。Windows 官方提供預編譯 DLL (https://windows.php.net/downloads/pecl/)，直接下載放入 `ext/` 目錄並啟用即可，無需編譯環境。

五、總結：當代 PHP 開發者的知識地圖

┌─────────────────────────────────────────────────────────────┐
│                     PHP 依賴管理全景                         │
├──────────────────────┬──────────────────────────────────────┤
│  純 PHP 庫/組件/框架  │  Composer (Packagist)                │
│  (業務邏輯、工具、SDK)│  → composer require vendor/pkg       │
├──────────────────────┼──────────────────────────────────────┤
│  C/C++ 性能擴展      │  PECL / 系統包管理器 / 官方預編譯 DLL │
│  (Redis、Swoole、    │  → apt/dnf/brew install php-pecl-xxx  │
│   ImageMagick、gRPC) │  → pecl install xxx (需編譯環境)      │
│                      │  → docker-php-ext-install xxx         │
├──────────────────────┼──────────────────────────────────────┤
│  核心內建擴展        │  PHP 內核編譯時啟用 (--with-xxx)      │
│  (PDO、JSON、MBString)│  或 docker-php-ext-install pdo_mysql │
└──────────────────────┴──────────────────────────────────────┘

結語

PEAR 奠基了 PHP 組件化標準，PECL 支撐著 PHP 性能天花板。**現代工作流：純 PHP 用 Composer，C 擴展用系統包/PECL/Docker，兩條線互不干擾，各司其職。** 理解這層架構邊界，才能在技術選型、CI/CD 構建、故障排查中遊刃有餘。