CentOS下如何安装phpredis扩展

封面图 • 2025-11-16 • Linux

在 CentOS 系统上安装 PHP 的 redis 扩展（`phpredis`）需要几个步骤。以下是详细的步骤说明：

---

### 1. 安装必要的依赖包
首先，确保系统已经安装了必要的工具和库。运行以下命令来安装这些依赖：

```bash
sudo yum install -y gcc make autoconf
```

此外，还需要安装 Redis 服务器和 PHP 开发环境的头文件：

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

---

### 2. 下载并编译 `phpredis` 扩展
1. **克隆或下载 `phpredis` 源码**  
   使用 Git 克隆官方仓库，或者直接从 [GitHub](https://github.com/phpredis/phpredis) 下载源码。

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

2. **编译扩展**  
   使用 `phpize` 工具生成构建文件，并执行 `make` 命令进行编译：

```bash
   /usr/bin/phpize
   ./configure --with-php-config=/usr/bin/php-config
   make
   ```

> 注意：如果系统中存在多个 PHP 版本，请确保使用与当前 PHP 安装对应的 `phpize` 和 `php-config`。

3. **安装扩展**  
   编译完成后，将生成的 `.so` 文件安装到 PHP 的扩展目录中：

```bash
   sudo make install
   ```

默认情况下，扩展会被安装到 `/usr/lib64/php/modules/` 或 `/usr/lib/php/modules/` 目录中。

---

### 3. 配置 PHP 加载 `phpredis` 扩展
编辑 PHP 的配置文件 `php.ini`，添加以下内容以启用 `phpredis` 扩展：

```bash
sudo vi /etc/php.ini
```

在文件末尾添加以下行：

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

保存并退出。

---

### 4. 测试扩展是否安装成功
创建一个测试脚本 `test.php` 来验证 `phpredis` 是否正常工作：

```php
<?php
$redis = new Redis();
$redis->connect('127.0.0.1', 6379);
if ($redis->ping() === '+PONG') {
    echo "Redis connection successful!";
} else {
    echo "Failed to connect to Redis.";
}
?>
```

运行该脚本：

```bash
php test.php
```

如果输出 `Redis connection successful!`，则说明安装成功。

---

### 5. 启动 Redis 服务
确保 Redis 服务正在运行，以便测试连接成功：

```bash
sudo systemctl start redis
sudo systemctl enable redis
```

---

### 总结
通过以上步骤，您可以在 CentOS 上成功安装并配置 PHP 的 `phpredis` 扩展。如果有任何问题，请检查以下几点：
- PHP 和 Redis 的版本是否匹配。
- `php.ini` 文件路径是否正确。
- 是否正确安装了所有依赖包。

如果您遇到具体错误信息，可以提供详细日志，我可以进一步帮助您解决问题！