安装redis和phpredis模块

封面图 • 2025-12-15 • PHP

安装 Redis 和 PHP 的 Redis 模块（phpredis）通常需要以下几个步骤。这里以 Linux 系统（如 Ubuntu 或 CentOS）为例，说明如何安装 Redis 服务器和 PHP 的 Redis 扩展。

---

## 一、安装 Redis 服务器

### 1. 安装 Redis（以 Ubuntu 为例）

```bash
sudo apt update
sudo apt install redis
```

或者从源码编译安装：

```bash
wget https://download.redis.io/redis-stable.tar.gz
tar -xzvf redis-stable.tar.gz
cd redis-stable
make
sudo make install
```

### 2. 启动 Redis 服务

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

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

```bash
redis-cli ping
```

如果返回 `PONG`，表示 Redis 已成功启动。

---

## 二、安装 PHP 的 Redis 模块（phpredis）

### 1. 安装 PHP 扩展依赖

确保你已经安装了 PHP 和 `php-dev` 包：

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

### 2. 下载并编译 phpredis

```bash
git clone https://github.com/phpredis/phpredis.git
cd phpredis
git checkout php8.0  # 根据你的 PHP 版本选择对应的分支
phpize
./configure
make
sudo make install
```

### 3. 配置 PHP 加载 phpredis 扩展

编辑 PHP 的配置文件（例如 `/etc/php/8.0/cli/php.ini` 或 `/etc/php/8.0/apache2/php.ini`）：

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

> 注意：路径可能因系统不同而略有差异，可以使用以下命令查找扩展路径：

```bash
find /usr/local/lib/php/extensions/no-debug-non-zts-*/ -name "redis.so"
```

然后在 `php.ini` 中添加相应的 `extension=` 行。

### 4. 重启 Web 服务器（如 Apache 或 Nginx）

```bash
sudo systemctl restart apache2
# 或者
sudo systemctl restart nginx
```

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

创建一个 PHP 文件（如 `info.php`）：

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

访问该文件，搜索 `redis`，如果能看到相关信息，说明安装成功。

---

## 三、使用 Redis 在 PHP 中

示例代码：

```php
<?php
$redis = new Redis();
$redis->connect('127.0.0.1', 6379);
$redis->set('key', 'value');
echo $redis->get('key');
?>
```

---

## 常见问题

### 1. `phpredis` 编译失败？

确保你已安装 `phpize` 和 `libpcre3-dev`（Ubuntu）等依赖：

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

### 2. 无法加载 `redis.so`？

检查 `php.ini` 中是否正确设置了扩展路径，或使用 `php -i | grep 'Loaded Configuration File'` 查看实际的配置文件位置。

---

如果你使用的是其他系统（如 macOS 或 Windows），或者使用 Docker，也可以告诉我，我可以提供更具体的指导。