# Redis
- [简介](#introduction)
- [配置](#configuration)
- [Predis](#predis)
- [PhpRedis](#phpredis)
- [Redis 交互](#interacting-with-redis)
- [管道命令](#pipelining-commands)
- [发布 / 订阅](#pubsub)
## 简介
[Redis](https://redis.io) 是一个开源的,高级键值对存储数据库。由于它包含 [字符串](https://redis.io/topics/data-types#strings), [哈希](https://redis.io/topics/data-types#hashes), [列表](https://redis.io/topics/data-types#lists), [集合](https://redis.io/topics/data-types#sets), 和 [有序集合](https://redis.io/topics/data-types#sorted-sets) 这些数据类型,所以它通常被称为数据结构服务器。
在使用 Laravel 的 Redis 之前,你需要通过 Composer 安装 `predis/predis` 扩展包:
composer require predis/predis
或者,你也可以通过 PECL 安装 [PhpRedis](https://github.com/phpredis/phpredis) PHP 扩展。这个扩展安装起来比较复杂,但对于大量使用 Redis 的应用程序来说可能会产生更好的性能。
### 配置
Laravel 应用的 Redis 配置都在配置文件 `config/database.php` 中。在这个文件里,你可以看到 `redis` 数组里包含了应用程序使用的 Redis 服务器信息:
'redis' => [
'client' => 'predis',
'default' => [
'host' => env('REDIS_HOST', '127.0.0.1'),
'password' => env('REDIS_PASSWORD', null),
'port' => env('REDIS_PORT', 6379),
'database' => env('REDIS_DB', 0),
],
'cache' => [
'host' => env('REDIS_HOST', '127.0.0.1'),
'password' => env('REDIS_PASSWORD', null),
'port' => env('REDIS_PORT', 6379),
'database' => env('REDIS_CACHE_DB', 1),
],
],
默认的服务器配置应该足以进行开发。当然,你也可以根据使用的环境来随意更改这个数组。只需在配置文件中给每个 Redis 服务器指定名称、host(主机)和 port(端口)即可。
#### 集群配置
如果你的应用使用 Redis 服务器集群,你应该在 Redis 配置文件中使用 `clusters` 键来定义这些集群:
'redis' => [
'client' => 'predis',
'clusters' => [
'default' => [
[
'host' => env('REDIS_HOST', 'localhost'),
'password' => env('REDIS_PASSWORD', null),
'port' => env('REDIS_PORT', 6379),
'database' => 0,
],
],
],
],
默认情况下,集群可以在节点上实现客户端分片,允许你实现节点池以及创建大量可用内存。这里要注意,客户端共享不会处理失败的情况;因此,这个功能主要适用于从另一个主数据库获取的缓存数据。如果要使用 Redis 原生集群,需要在配置文件下的 `options` 键中做出如下指定:
'redis' => [
'client' => 'predis',
'options' => [
'cluster' => 'redis',
],
'clusters' => [
// ...
],
],
### Predis
除了默认的 `host`, `port`, `database`, 和 `password` 这些服务配置选项外,Predis 还支持为每个 Redis 服务器定义其它的链接参数 [connection parameters](https://github.com/nrk/predis/wiki/Connection-Parameters) 。如果要使用这些额外的配置选项,可以将以下配置添加到 Redis 服务器的配置文件 `config/database.php` 中:
'default' => [
'host' => env('REDIS_HOST', 'localhost'),
'password' => env('REDIS_PASSWORD', null),
'port' => env('REDIS_PORT', 6379),
'database' => 0,
'read_write_timeout' => 60,
],
### PhpRedis
要使用 PhpRedis 扩展,需要将配置文件 `config/database.php` 中 Redis 配置的 `client` 选项修改为 `phpredis`:
'redis' => [
'client' => 'phpredis',
// 其余的Redis配置...
],
除了默认的 `host`, `port`, `database` 和 `password` 这些服务配置选项外,PhpRedis 还支持以下几个额外的连接参数: `persistent`, `prefix`, `read_timeout` 和 `timeout` 。你可以将这些配置选项添加到配置文件 `config/database.php` 中 Redis 服务配置项下:
'default' => [
'host' => env('REDIS_HOST', 'localhost'),
'password' => env('REDIS_PASSWORD', null),
'port' => env('REDIS_PORT', 6379),
'database' => 0,
'read_timeout' => 60,
],
## Redis交互
你可以通过调用 `Redis` [facade](/docs/{{version}}/facades)上的各种方法来与Redis 交互。`Redis` facade 支持动态方法,意味着你可以在 facade 上调用各种 [Redis 命令](https://redis.io/commands) ,命令将直接传递给 Redis。在示例中,将通过 `Redis` facade 上的 `get` 方法来调用 Redis上的 `GET` 命令:
$user]);
}
}
如上所述,你可以在 `Redis` facade 上调用任意 Redis 命令。Laravel 使用魔术方法将命令传递给 Redis 服务器,因此只需传递 Redis 命令所需的参数即可:
Redis::set('name', 'Taylor');
$values = Redis::lrange('names', 5, 10);
或者,你也可以使用 `command` 方法将命令传递给服务器,它接受命令的名称作为其第一个参数,并将值的数组作为其第二个参数:
$values = Redis::command('lrange', ['name', 5, 10]);
#### 使用多个 Redis 连接
你可以通过 `Redis::connection` 方法获得 Redis 实例:
$redis = Redis::connection();
这会返回一个默认的 Redis 实例。你可以传递连接或者集群名称给 `connection` 方法来获取在 Redis 配置中特定服务或集群:
$redis = Redis::connection('my-connection');
### 管道命令
当你需要在一个操作中给服务器发送很多命令时,推荐你使用管道命令。 `pipeline` 方法接受一个 Redis 实例的 `闭包` 。你可以将所有的命令发送给 Redis 实例,它们都会在一个操作中执行完成:
Redis::pipeline(function ($pipe) {
for ($i = 0; $i < 1000; $i++) {
$pipe->set("key:$i", $i);
}
});
## 发布与订阅
Laravel 为 Redis 的 `publish` 及 `subscribe` 提供了方便的接口。这些 Redis 命令让你可以监听指定「频道」上的消息。你可以从另一个应用程序发布消息给另一个应用程序,甚至使用其它编程语言,让应用程序和进程之间能够轻松进行通信。
首先,我们使用 `subscribe` 方法设置频道监听器。我们将这个方法调用放在 [Artisan 命令](/docs/{{version}}/artisan) 中,因为调用 `subscribe` 方法会启动一个长时间运行的进程:
'bar']));
});
#### 通配符订阅
使用 `psubscribe` 方法可以订阅通配符频道,可以用来在所有频道上获取所有消息。 `$channel` 名称将作为第二个参数传递给提供的回调 `闭包`:
Redis::psubscribe(['*'], function ($message, $channel) {
echo $message;
});
Redis::psubscribe(['users.*'], function ($message, $channel) {
echo $message;
});