PHP连接Redis

封面图 • 2025-11-10 • PHP

在 PHP 中连接 Redis 主要使用 `php-redis` 扩展，这是一个官方提供的 PHP 驱动，支持与 Redis 数据库进行交互。以下是使用 PHP 连接 Redis 的基本步骤和示例代码。

---

## ✅ 一、安装 php-redis 扩展

### 1. 使用 PECL 安装（推荐）

```bash
pecl install redis
```

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

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

（Linux 系统下是 `.so`，Windows 下是 `.dll`）

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

如果你使用 Composer，也可以通过 `predis/predis` 这个客户端来连接 Redis（不依赖原生扩展）：

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

---

## ✅ 二、PHP 连接 Redis 示例

### 1. 使用原生 `Redis` 类（需要安装 `php-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（无需安装原生扩展）

```php
<?php

require 'vendor/autoload.php';

use Predis\Client;

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

// 设置键值对
$client->set('username', 'Alice');

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

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

---

## ✅ 三、常见操作示例

| 操作 | 方法 | 示例 |
|------|------|------|
| 设置键值 | `set()` | `$redis->set('key', 'value')` |
| 获取值 | `get()` | `$redis->get('key')` |
| 删除键 | `del()` | `$redis->del('key')` |
| 判断键是否存在 | `exists()` | `$redis->exists('key')` |
| 设置过期时间 | `expire()` | `$redis->expire('key', 60)` |
| 获取所有键 | `keys()` | `$redis->keys('*')` |

---

## ✅ 四、连接 Redis 的高级配置（如密码、数据库选择）

```php
$redis = new Redis();
$redis->connect('127.0.0.1', 6379);
$redis->auth('your_password'); // 如果有密码
$redis->select(1); // 选择数据库编号 1
```

---

## ✅ 五、错误处理建议

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

---

## 📌 注意事项

- 确保 Redis 服务正在运行：`sudo service redis-server start`
- 防火墙允许 6379 端口访问（如果远程连接）
- 生产环境建议使用 `predis` 或 `php-redis` 并配置连接池或使用缓存中间件（如 Laravel 的 Cache）

---

如果你需要连接远程 Redis 服务器、使用 SSL、集群模式等，也可以告诉我，我可以提供更详细的配置方式。