PHP8 安装 redis 扩展

封面图 • 2025-10-21 • PHP

在 PHP 8 中安装 Redis 扩展，通常使用 `pecl` 或者通过源码编译的方式。以下是详细的步骤：

---

## ✅ 方法一：使用 `pecl` 安装（推荐）

### 1. 确保已安装 PHP 8 和开发工具

确保你已经安装了 PHP 8 及其开发包（`php-dev` 或 `php-devel`）。

在 Ubuntu/Debian 上：

```bash
sudo apt update
sudo apt install php8.0 php8.0-dev php-pear
```

在 CentOS/RHEL 上：

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

---

### 2. 安装 `pecl` 扩展

运行以下命令来安装 Redis 扩展：

```bash
sudo pecl install redis
```

> 如果提示找不到 `pecl`，请先安装 `php-pear`（如上面的步骤）。

---

### 3. 启用扩展

安装完成后，需要将扩展添加到 `php.ini` 文件中。

查找 `php.ini` 的位置：

```bash
php --ini
```

通常路径是 `/etc/php/8.0/cli/php.ini` 或 `/etc/php/8.0/apache2/php.ini`（根据你的环境）。

在文件末尾添加：

```ini
extension=redis.so
```

---

### 4. 重启 Web 服务器（如果使用 Apache/Nginx）

例如，重启 Apache：

```bash
sudo systemctl restart apache2
```

或者 Nginx + PHP-FPM：

```bash
sudo systemctl restart php8.0-fpm
sudo systemctl restart nginx
```

---

### 5. 验证是否安装成功

创建一个 `info.php` 文件：

```php
<?php
phpinfo();
?>
```

访问该文件，查看是否有 `redis` 模块信息。

---

## ✅ 方法二：从源码编译安装（适用于没有 `pecl` 的情况）

### 1. 下载 Redis 扩展源码

```bash
git clone https://github.com/phpredis/phpredis.git
cd phpredis
```

---

### 2. 使用 `phpize` 编译

```bash
phpize
./configure
make
sudo make install
```

---

### 3. 启用扩展（同上）

在 `php.ini` 中添加：

```ini
extension=redis.so
```

---

## ✅ 常见问题

### ❗错误：`phpize: command not found`

你需要安装 `php-dev` 或 `php-devel` 包，如：

Ubuntu:

```bash
sudo apt install php8.0-dev
```

CentOS:

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

---

### ❗错误：`Cannot find autoconf`

安装 `autoconf`：

Ubuntu:

```bash
sudo apt install autoconf
```

CentOS:

```bash
sudo yum install autoconf
```

---

## ✅ 总结

| 步骤 | 内容 |
|------|------|
| 安装依赖 | `php-dev`, `php-pear` |
| 安装扩展 | `pecl install redis` 或从源码编译 |
| 启用扩展 | 在 `php.ini` 添加 `extension=redis.so` |
| 重启服务 | Apache/Nginx |
| 验证 | `phpinfo()` 查看 Redis 模块 |

---

如果你使用的是 Docker 或其他环境，请告诉我，我可以提供相应的安装方式。