PHP 使用 Redis

封面图 • 2025-10-29 • PHP

在 PHP 中使用 Redis 是一种常见的做法，用于缓存、会话管理、消息队列等场景。下面我将为你介绍如何在 PHP 中使用 Redis。

---

## ✅ 一、安装 Redis 扩展

PHP 使用 Redis 需要安装 `php-redis` 扩展。以下是不同系统的安装方法：

### Linux（Ubuntu/Debian）：
```bash
sudo apt-get install php-redis
```

### Linux（CentOS/RHEL）：
```bash
sudo yum install php-redis
```

### Windows：
下载对应的 DLL 文件（如 `php_redis.dll`），并将其放入 `ext` 目录中，然后在 `php.ini` 中添加：
```ini
extension=php_redis.dll
```

重启 Apache 或 Nginx。

---

## ✅ 二、连接 Redis

在 PHP 中使用 Redis，通常使用 `Redis` 类。

```php
<?php
$redis = new Redis();

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

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

echo "Connection to Redis successful";
?>
```

---

## ✅ 三、基本操作示例

以下是一些常用的 Redis 操作：

### 1. 设置键值对
```php
$redis->set('name', 'John Doe');
```

### 2. 获取键值
```php
$name = $redis->get('name');
echo $name; // 输出: John Doe
```

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

### 4. 删除键
```php
$redis->del('name');
```

### 5. 判断键是否存在
```php
if ($redis->exists('name')) {
    echo "Key exists";
} else {
    echo "Key does not exist";
}
```

### 6. 获取所有键（不推荐在生产环境使用）
```php
$keys = $redis->keys('*');
print_r($keys);
```

### 7. 使用 Hash 数据结构
```php
$redis->hSet('user:1001', 'name', 'Alice');
$redis->hSet('user:1001', 'age', 25);

$name = $redis->hGet('user:1001', 'name');
echo $name; // Alice
```

### 8. 使用 List 数据结构
```php
$redis->rpush('mylist', 'item1');
$redis->rpush('mylist', 'item2');

$items = $redis->lrange('mylist', 0, -1);
print_r($items); // Array ( [0] => item1 [1] => item2 )
```

### 9. 使用 Set 数据结构
```php
$redis->sAdd('myset', 'a');
$redis->sAdd('myset', 'b');
$redis->sAdd('myset', 'a'); // 重复添加不会生效

$members = $redis->sMembers('myset');
print_r($members); // Array ( [0] => a [1] => b )
```

---

## ✅ 四、使用 Redis 作为缓存

```php
function get_cached_data($key) {
    global $redis;

if ($redis->exists($key)) {
        return $redis->get($key);
    } else {
        // 模拟从数据库获取数据
        $data = "This is the data from database.";
        $redis->set($key, $data, 3600); // 缓存 1 小时
        return $data;
    }
}

$data = get_cached_data('my_cache_key');
echo $data;
```

---

## ✅ 五、连接池与持久化连接（高级）

如果你的项目需要高性能，可以考虑使用连接池或持久化连接：

```php
$redis = new Redis();
$redis->pconnect('127.0.0.1', 6379); // 持久化连接
```

---

## ✅ 六、错误处理

建议在使用 Redis 时加上错误处理：

```php
if (!$redis->isConnected()) {
    die("Failed to connect to Redis");
}
```

---

## ✅ 七、常用命令总结

| 命令 | 说明 |
|------|------|
| `set` | 设置键值 |
| `get` | 获取键值 |
| `del` | 删除键 |
| `exists` | 判断键是否存在 |
| `keys` | 获取所有键（测试用） |
| `hset` / `hget` | Hash 操作 |
| `rpush` / `lrange` | List 操作 |
| `sadd` / `smembers` | Set 操作 |

---

## ✅ 八、扩展：使用 Predis 客户端（可选）

除了原生的 `php-redis` 扩展，你也可以使用第三方库如 [Predis](https://github.com/predis/predis)：

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

示例：
```php
require 'vendor/autoload.php';

use Predis\Client;

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

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

---

## ✅ 九、常见问题

### Q: 无法连接到 Redis？
- 检查 Redis 是否正在运行：`redis-server`
- 检查防火墙设置
- 检查 `php.ini` 中是否加载了 `redis.so` 或 `php_redis.dll`

### Q: Redis 返回空值？
- 可能是键不存在，或者设置了过期时间
- 使用 `exists` 方法判断键是否存在

---

如果你有具体的使用场景（如缓存、会话存储、消息队列等），我可以提供更详细的示例和优化建议。欢迎继续提问！