centos redis 安装 php-redis扩展安装及使用

封面图 • 2025-09-19 • PHP

在 CentOS 系统中安装 Redis 以及 PHP 的 `php-redis` 扩展（即 `redis` 扩展）是一个常见的操作，用于让 PHP 应用程序能够与 Redis 数据库进行交互。以下是详细的步骤：

---

## 一、安装 Redis 服务

### 1. 安装 EPEL 仓库（如果尚未安装）

```bash
sudo yum install -y epel-release
```

### 2. 安装 Redis

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

### 3. 启动并设置 Redis 开机自启

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

### 4. 验证 Redis 是否运行

```bash
redis-cli ping
```

如果返回 `PONG`，说明 Redis 正常运行。

---

## 二、安装 PHP 的 redis 扩展

### 1. 安装 PHP 的 redis 扩展

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

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

> 如果提示 `pecl` 未找到，请先安装 `php-pear`：

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

然后再次运行 `pecl install redis`。

#### 方法二：使用 `yum` 安装（如果存在对应的包）

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

> 注意：有些 CentOS 版本可能没有这个包，建议使用 `pecl` 方式安装。

---

### 2. 启用 redis 扩展

安装完成后，需要将扩展添加到 PHP 的配置文件中：

```bash
echo "extension=redis.so" | sudo tee /etc/php.d/redis.ini
```

或者编辑 `php.ini` 文件：

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

在末尾添加：

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

---

### 3. 重启 PHP-FPM 或 Apache（根据你的 Web 服务器）

- **如果是 Apache**：

```bash
sudo systemctl restart httpd
```

- **如果是 Nginx + PHP-FPM**：

```bash
sudo systemctl restart php-fpm
```

---

## 三、验证 PHP 的 redis 扩展是否安装成功

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

```bash
echo "<?php phpinfo(); ?>" > /var/www/html/info.php
```

然后访问 `http://your-server-ip/info.php`，搜索 `redis`，如果有显示相关信息，说明安装成功。

---

## 四、PHP 使用 Redis 示例

以下是一个简单的 PHP 使用 Redis 的示例代码：

```php
<?php
$redis = new Redis();
$redis->connect('127.0.0.1', 6379);

// 设置键值对
$redis->set('test_key', 'Hello, Redis!');

// 获取键值对
$value = $redis->get('test_key');
echo "Value: " . $value;
?>
```

将这段代码保存为 `test_redis.php` 并访问它，应该能看到输出内容。

---

## 五、常见问题排查

| 问题 | 解决方案 |
|------|----------|
| `extension=redis.so not found` | 检查 `php.ini` 中的路径是否正确，或重新安装扩展 |
| `redis-cli ping` 返回 `Connection refused` | 检查 Redis 是否启动，防火墙是否开放 6379 端口 |
| `Call to undefined function redis()` | 扩展未正确加载，检查 `php.ini` 或 `/etc/php.d/redis.ini` |

---

如果你使用的是 PHP 8.x，确保你安装的是兼容的版本，例如 `pecl install redis` 会自动适配。

如需进一步配置 Redis（如设置密码、绑定 IP、持久化等），可以修改 `/etc/redis.conf` 文件。

---

如需我帮你生成完整的安装脚本或配置文件，也可以告诉我你的具体环境（如 PHP 版本、CentOS 版本）。

centos redis 安装 php-redis扩展安装 及使用

centos redis 安装 php-redis扩展安装及使用