PHP 操作redis 详细讲解

封面图 • 2026-01-08 • redis

当然！下面是一份关于 **PHP 操作 Redis 的详细讲解**，包括安装、连接、常用命令、数据类型操作、事务、发布订阅等。

---

## 一、什么是 Redis？

Redis（Remote Dictionary Server）是一个开源的内存数据库，支持多种数据结构（字符串、哈希、列表、集合、有序集合等），常用于缓存、消息队列、分布式锁等场景。

---

## 二、PHP 操作 Redis 的方式

PHP 操作 Redis 主要有两种方式：

1. **使用 `redis` 扩展**（推荐）
2. **使用 `Predis` 客户端库**（第三方库）

### 1. 使用 redis 扩展（推荐）

#### 安装 redis 扩展

在 PHP 中使用 Redis 需要安装 `redis` 扩展。可以通过 PECL 或者源码编译安装。

```bash
pecl install redis
```

然后在 `php.ini` 中添加：

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

重启 PHP 服务后即可使用。

---

## 三、PHP 连接 Redis

```php
<?php
// 创建 Redis 实例
$redis = new Redis();

// 连接 Redis 服务器
$redis->connect('127.0.0.1', 6379);

// 设置密码（如果配置了）
$redis->auth('your_password');

// 选择数据库（默认是 0）
$redis->select(0);
```

---

## 四、Redis 常用数据类型及操作

### 1. 字符串（String）

```php
// 存储
$redis->set('name', 'John');

// 获取
$name = $redis->get('name'); // 输出: John

// 设置过期时间（秒）
$redis->setex('temp_key', 60, 'value'); // 60 秒后过期

// 自增
$redis->incr('counter'); // 返回自增后的值
```

### 2. 哈希（Hash）

```php
// 存储字段
$redis->hSet('user:1001', 'name', 'Alice');
$redis->hSet('user:1001', 'age', 25);

// 获取字段
$name = $redis->hGet('user:1001', 'name'); // Alice

// 获取所有字段
$fields = $redis->hGetAll('user:1001');
```

### 3. 列表（List）

```php
// 左边插入
$redis->lPush('mylist', 'A');
$redis->lPush('mylist', 'B');

// 右边插入
$redis->rPush('mylist', 'C');

// 获取列表
$list = $redis->lRange('mylist', 0, -1); // ['B', 'A', 'C']
```

### 4. 集合（Set）

```php
// 添加元素
$redis->sAdd('myset', 'a');
$redis->sAdd('myset', 'b');

// 获取集合中的所有元素
$members = $redis->sMembers('myset'); // ['a', 'b']

// 判断是否包含某个元素
$contains = $redis->sIsMember('myset', 'a'); // true
```

### 5. 有序集合（Sorted Set）

```php
// 添加元素并设置分数
$redis->zAdd('myzset', 10, 'a');
$redis->zAdd('myzset', 20, 'b');

// 获取所有元素及其分数
$zset = $redis->zRange('myzset', 0, -1, true); // ['a' => 10, 'b' => 20]

// 获取指定范围内的元素（按分数排序）
$range = $redis->zRangeByScore('myzset', 10, 20); // ['a', 'b']
```

---

## 五、事务（Transaction）

Redis 支持事务操作，可以使用 `multi` 和 `exec` 来执行一组命令。

```php
$redis->multi(); // 开始事务
$redis->set('key1', 'value1');
$redis->set('key2', 'value2');
$redis->exec(); // 执行事务
```

> 注意：PHP 的 `Redis` 类中 `multi()` 方法返回的是一个布尔值，表示是否成功开启事务。

---

## 六、发布/订阅（Pub/Sub）

Redis 支持消息的发布和订阅机制。

### 发布者（Publisher）

```php
$redis->publish('channel_name', 'Hello, Redis!');
```

### 订阅者（Subscriber）

```php
$redis->subscribe(['channel_name'], function ($redis, $channel, $message) {
    echo "Received: $message on channel $channel\n";
});
```

> 注意：`subscribe()` 是阻塞方法，需要运行在独立的进程或线程中。

---

## 七、PHP 使用 Predis（可选）

如果你不想安装 `redis` 扩展，可以使用 **Predis** 这个 PHP 客户端库。

### 安装 Predis

```bash
composer require predis/predis
```

### 示例代码

```php
require 'vendor/autoload.php';

use Predis\Client;

$client = new Client([
    'scheme' => 'tcp',
    'host'   => '127.0.0.1',
    'port'   => 6379,
]);

$client->set('name', 'John');
echo $client->get('name'); // John
```

---

## 八、常见错误处理

- `Connection refused`: Redis 服务未启动或端口错误。
- `No such key`: 键不存在。
- `Invalid argument`: 参数错误，如 `setex` 的第二个参数必须是整数。

---

## 九、性能优化建议

- 尽量使用 `pipeline` 批量操作，减少网络延迟。
- 合理使用 TTL（过期时间）控制缓存生命周期。
- 避免存储大对象（如超长字符串）。
- 使用 `Lua` 脚本进行复杂操作，保证原子性。

---

## 十、总结

| 功能 | PHP 操作 Redis |
|------|----------------|
| 连接 | `new Redis()->connect()` |
| 字符串 | `set()`, `get()` |
| 哈希 | `hSet()`, `hGet()` |
| 列表 | `lPush()`, `lRange()` |
| 集合 | `sAdd()`, `sMembers()` |
| 有序集合 | `zAdd()`, `zRange()` |
| 事务 | `multi()`, `exec()` |
| 发布订阅 | `publish()`, `subscribe()` |

---

如果你有具体的使用场景（如缓存、计数器、分布式锁等），我也可以为你提供更详细的示例代码。

是否需要我给你一个完整的 Redis 缓存类示例？