php安装 pear,php pear / pecl 扩展工具的安装和使用

封面图 • 2026-01-11 • PHP

在 PHP 中，**PEAR**（PHP Extension and Application Repository）和 **PECL**（PHP Extension Community Library）是两个用于管理 PHP 扩展的工具。它们分别用于安装 PHP 的库（PEAR）和扩展（PECL）。下面将详细介绍如何安装和使用 PEAR 和 PECL。

---

## 一、安装 PEAR

### 1. 安装 PEAR

PEAR 通常已经包含在 PHP 的标准发行版中，但如果你的系统中没有安装，可以手动安装。

#### 在 Linux 系统上（如 Ubuntu/Debian）

```bash
sudo apt-get install php-pear
```

#### 在 macOS 上（使用 Homebrew）

```bash
brew install php@8.2  # 请根据你的 PHP 版本替换
```

或者从源码安装：

```bash
wget https://pear.php.net/go-pear.phar
php go-pear.phar
```

运行后按照提示操作即可。

---

### 2. 配置 PEAR

安装完成后，你可以通过以下命令查看 PEAR 是否安装成功：

```bash
pear version
```

如果出现版本号，说明安装成功。

你也可以设置 PEAR 的默认路径：

```bash
pear config-set php_dir /usr/local/lib/php
pear config-set doc_dir /usr/local/share/pear/docs
```

---

## 二、安装 PECL

PECL 是用于安装 PHP 扩展的工具，它与 PEAR 类似，但专门用于扩展（例如 `memcached`、`xdebug` 等）。

### 1. 安装 PECL

PECL 通常也随 PHP 一起安装，但如果没有安装，可以通过 PEAR 来安装：

```bash
pear install pecl
```

或者直接从源码安装：

```bash
wget https://pecl.php.net/get/pecl-1.10.5.tgz
tar -zxvf pecl-1.10.5.tgz
cd pecl-1.10.5
phpize
./configure
make
sudo make install
```

---

### 2. 使用 PECL 安装扩展

```bash
pecl install package_name
```

例如安装 `xdebug`：

```bash
pecl install xdebug
```

安装完成后，需要在 `php.ini` 文件中添加扩展：

```ini
extension=xdebug.so
```

然后重启 PHP 服务（如 Apache 或 Nginx + PHP-FPM）。

---

## 三、常用 PEAR 命令

| 命令 | 说明 |
|------|------|
| `pear list` | 列出已安装的 PEAR 包 |
| `pear search package_name` | 搜索 PEAR 包 |
| `pear install package_name` | 安装 PEAR 包 |
| `pear uninstall package_name` | 卸载 PEAR 包 |
| `pear info package_name` | 查看包信息 |
| `pear update` | 更新 PEAR 工具 |

---

## 四、常用 PECL 命令

| 命令 | 说明 |
|------|------|
| `pecl list` | 列出已安装的 PECL 扩展 |
| `pecl search package_name` | 搜索 PECL 扩展 |
| `pecl install package_name` | 安装 PECL 扩展 |
| `pecl uninstall package_name` | 卸载 PECL 扩展 |
| `pecl info package_name` | 查看扩展信息 |

---

## 五、配置 PHP 以使用 PEAR/PECL

确保 `php.ini` 中有如下配置：

```ini
include_path = ".:/usr/local/lib/php"
```

或者通过命令行设置：

```bash
pear config-set include_path .:/usr/local/lib/php
```

---

## 六、常见问题

### 1. 安装 PECL 扩展时提示找不到 `phpize`

这表示你没有安装 `php-dev` 或 `php-devel` 包。

#### Ubuntu/Debian:

```bash
sudo apt-get install php-dev
```

#### CentOS/RHEL:

```bash
sudo yum install php-devel
```

---

### 2. 安装 PECL 后无法加载扩展

检查 `php.ini` 是否正确设置了扩展路径，并确认扩展文件是否存在。

---

## 七、推荐使用 Composer 替代 PEAR/PECL

虽然 PEAR 和 PECL 仍然可用，但现在更推荐使用 **Composer** 来管理 PHP 库和依赖。Composer 更现代、更灵活。

安装 Composer：

```bash
curl -sS https://getcomposer.org/installer | php
```

然后使用：

```bash
composer require vendor/package
```

---

## 八、总结

| 工具 | 用途 | 安装方式 |
|------|------|----------|
| PEAR | 安装 PHP 库（非扩展） | `pear install package` |
| PECL | 安装 PHP 扩展（C 语言扩展） | `pecl install package` |
| Composer | 推荐的现代 PHP 包管理器 | `composer install` |

---

如果你有具体的扩展或包需要安装，可以告诉我名称，我可以提供详细步骤。