PHP 使用 Redis

封面图 • 2025-12-17 • PHP

在 PHP 中使用 Redis 可以通过 **PHP-Redis** 扩展来实现。这个扩展提供了与 Redis 数据库交互的接口，支持各种 Redis 命令。

---

## ✅ 一、安装 PHP-Redis 扩展

### 1. 使用 `pecl` 安装（推荐）

```bash
pecl install redis
```

安装完成后，在 `php.ini` 文件中添加：

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

> Windows 系统则需要下载对应的 DLL 文件，并将其放在 PHP 的 `ext` 目录下，然后在 `php.ini` 中添加 `extension=php_redis.dll`。

### 2. 使用 Composer 安装（可选）

如果你不想直接安装扩展，也可以使用 [Predis](https://github.com/predis/predis) 这个 PHP 客户端库（基于纯 PHP 实现）：

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

---

## ✅ 二、基本使用示例

### 1. 使用原生 Redis 扩展

```php
<?php

// 创建 Redis 连接
$redis = new Redis();

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

// 设置一个键值对
$redis->set('name', 'John Doe');

// 获取值
$name = $redis->get('name');
echo "Name: " . $name;

// 删除键
$redis->del('name');

// 关闭连接
$redis->close();
```

### 2. 使用 Predis（Composer 安装）

```php
<?php

require 'vendor/autoload.php';

use Predis\Client;

// 创建客户端
$client = new Client([
    'host' => '127.0.0.1',
    'port' => 6379,
]);

// 设置键值
$client->set('name', 'Jane Doe');

// 获取值
$name = $client->get('name');
echo "Name: " . $name;

// 删除键
$client->del('name');
```

---

## ✅ 三、常用 Redis 操作

| 操作 | 示例 |
|------|------|
| set | `$redis->set('key', 'value')` |
| get | `$redis->get('key')` |
| del | `$redis->del('key')` |
| exists | `$redis->exists('key')` |
| incr | `$redis->incr('counter')` |
| decr | `$redis->decr('counter')` |
| expire | `$redis->expire('key', 60)` |
| ttl | `$redis->ttl('key')` |
| lpush | `$redis->lpush('list', 'item')` |
| rpop | `$redis->rpop('list')` |
| hset | `$redis->hset('hash', 'field', 'value')` |
| hget | `$redis->hget('hash', 'field')` |

---

## ✅ 四、连接池 & 配置优化（高级）

如果项目中使用了多个 Redis 实例或需要高并发，建议使用连接池或配置集群模式。

例如使用 Predis 的集群模式：

```php
$client = new Client([
    'cluster' => 'redis',
    'servers' => [
        'tcp://127.0.0.1:6379',
        'tcp://127.0.0.1:6380',
    ],
]);
```

---

## ✅ 五、常见问题

### Q: 如何检查 Redis 是否连接成功？

```php
if ($redis->ping() === 'PONG') {
    echo 'Connected to Redis!';
}
```

### Q: Redis 超时设置？

```php
$redis->setex('key', 60, 'value'); // 设置 key 并在 60 秒后过期
```

---

## ✅ 六、参考资料

- [PHP Redis 扩展官方文档](https://www.php.net/manual/zh/book.redis.php)
- [Predis GitHub 仓库](https://github.com/predis/predis)

---

如需我帮你写具体的代码示例（比如缓存、队列、分布式锁等），欢迎继续提问！