Redis

未匹配的标注
本文档最新版为 10.x,旧版本可能放弃维护,推荐阅读最新版!

Redis

简介

Redis 是一个开源的,高级键值对存储数据库。由于它包含 字符串, 哈希, 列表, 集合, 和 有序集合 这些数据类型,所以它通常被称为数据结构服务器。

在将 Redis 与 Laravel 一起使用之前,我们鼓励你通过 PECL 安装并使用PhpRedis PHP扩展。 尽管扩展安装起来更复杂,但对于大量使用 Redis 的应用程序可能会产生更好的性能。

或者,您可以通过 Composer 安装predis / predis包:

composer require predis/predis

注意:Predis 已被该软件包的原始作者遗弃,并可能在将来的版本中从 Laravel 中删除。

配置

Laravel 应用的 Redis 配置都在配置文件 config/database.php 中。在这个文件里,你可以看到 redis 数组里包含了应用程序使用的 Redis 服务器信息:

'redis' => [

    'client' => env('REDIS_CLIENT', 'phpredis'),

    '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' => env('REDIS_CLIENT', 'phpredis'),

    'clusters' => [
        'default' => [
            [
                'host' => env('REDIS_HOST', 'localhost'),
                'password' => env('REDIS_PASSWORD', null),
                'port' => env('REDIS_PORT', 6379),
                'database' => 0,
            ],
        ],
    ],

],

默认情况下,集群可以在节点上实现客户端分片,允许你实现节点池以及创建大量可用内存。这里要注意,客户端共享不会处理失败的情况;因此,这个功能主要适用于从另一个主数据库获取的缓存数据。如果要使用 Redis 原生集群,需要在配置文件下的 options 键中做出如下指定:

'redis' => [

    'client' => env('REDIS_CLIENT', 'phpredis'),

    'options' => [
        'cluster' => env('REDIS_CLUSTER', 'redis'),
    ],

    'clusters' => [
        // ...
    ],

],

Predis

如果您要使用Predis扩展,您应该将 REDIS_CLIENT 环境变量从 phpredis 更改为predis

'redis' => [

    'client' => env('REDIS_CLIENT', 'predis'),

    // Rest of Redis configuration...
],

除了默认的 host, port, database, 和 password 这些服务配置选项外,Predis 还支持为每个 Redis 服务器定义其它的链接参数 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 扩展,您应该在 env 配置REDIS_CLIENTconfig/database.php 配置中为默认值:

'redis' => [

    'client' => env('REDIS_CLIENT', 'phpredis'),

    // 其余的 Redis 配置...
],

如果您计划将 PhpRedis 扩展名与Redis Facade 别名一起使用,则应将其重命名为其他内容,例如RedisManager,以避免与 Redis 类发生冲突。 您可以在app.php配置文件的别名部分执行此操作。

'RedisManager' => Illuminate\Support\Facades\Redis::class,

除了默认的 hostportdatabasepassword 这些服务配置选项外,PhpRedis 还支持以下几个额外的连接参数: persistentprefixread_timeouttimeout 。你可以将这些配置选项添加到配置文件 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 Facade

为了避免与Redis PHP扩展本身发生类命名冲突,您需要从app配置文件的aliases数组中删除或重命名Illuminate \ Support \ Facades \ Redis外观别名。 通常,您应该完全删除此别名,并且仅在使用 Redis PHP 扩展时通过其完全限定的类名引用 Facade 。

Redis交互

你可以通过调用 Redis facade上的各种方法来与Redis 交互。Redis facade 支持动态方法,意味着你可以在 facade 上调用各种 Redis 命令 ,命令将直接传递给 Redis。在示例中,将通过 Redis facade 上的 get 方法来调用 Redis上的 GET 命令:

<?php

namespace App\Http\Controllers;

use App\Http\Controllers\Controller;
use Illuminate\Support\Facades\Redis;

class UserController extends Controller
{
    /**
     * 显示给定用户的配置文件。
     *
     * @param  int  $id
     * @return Response
     */
    public function showProfile($id)
    {
        $user = Redis::get('user:profile:'.$id);

        return view('user.profile', ['user' => $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 的 publishsubscribe 提供了方便的接口。这些 Redis 命令让你可以监听指定「频道」上的消息。你可以从另一个应用程序发布消息给另一个应用程序,甚至使用其它编程语言,让应用程序和进程之间能够轻松进行通信。

首先,我们使用 subscribe 方法设置频道监听器。我们将这个方法调用放在 Artisan 命令 中,因为调用 subscribe 方法会启动一个长时间运行的进程:

<?php

namespace App\Console\Commands;

use Illuminate\Console\Command;
use Illuminate\Support\Facades\Redis;

class RedisSubscribe extends Command
{
    /**
     * The name and signature of the console command.
     *
     * @var string
     */
    protected $signature = 'redis:subscribe';

    /**
     * The console command description.
     *
     * @var string
     */
    protected $description = 'Subscribe to a Redis channel';

    /**
     * Execute the console command.
     *
     * @return mixed
     */
    public function handle()
    {
        Redis::subscribe(['test-channel'], function ($message) {
            echo $message;
        });
    }
}

现在我们可以使用 publish 方法将消息发布到频道:

Route::get('publish', function () {
    // Route logic...

    Redis::publish('test-channel', json_encode(['foo' => 'bar']));
});

通配符订阅

使用 psubscribe 方法可以订阅通配符频道,可以用来在所有频道上获取所有消息。 $channel 名称将作为第二个参数传递给提供的回调 闭包:

Redis::psubscribe(['*'], function ($message, $channel) {
    echo $message;
});

Redis::psubscribe(['users.*'], function ($message, $channel) {
    echo $message;
});

本文章首发在 LearnKu.com 网站上。

本译文仅用于学习和交流目的,转载请务必注明文章译者、出处、和本文链接
我们的翻译工作遵照 CC 协议,如果我们的工作有侵犯到您的权益,请及时联系我们。

原文地址:https://learnku.com/docs/laravel/6.x/red...

译文地址:https://learnku.com/docs/laravel/6.x/red...

上一篇 下一篇
《L04 微信小程序从零到发布》
从小程序个人账户申请开始,带你一步步进行开发一个微信小程序,直到提交微信控制台上线发布。
《L02 从零构建论坛系统》
以构建论坛项目 LaraBBS 为线索,展开对 Laravel 框架的全面学习。应用程序架构思路贴近 Laravel 框架的设计哲学。
贡献者:5
讨论数量: 9
发起讨论 只看当前版本


miaotiao
(已经解决) Laravel Redis predis 切换到 phpredis
2 个点赞 | 26 个回复 | 问答 | 课程版本 5.7
Taris
什麼情況下會使用 Redis???
1 个点赞 | 4 个回复 | 问答 | 课程版本 5.6
cxywsw
提个小小的建议,redis支持设置默认过期时间
0 个点赞 | 6 个回复 | 分享 | 课程版本 9.x
Curtain123
短信登录
0 个点赞 | 3 个回复 | 代码速记 | 课程版本 8.5
梦之马
长时间 Redis:subscribe 会断开怎么解决
0 个点赞 | 3 个回复 | 问答 | 课程版本 5.5
397948486
Laravel Redis 切换 phpredis 遇到 read error on connection
0 个点赞 | 2 个回复 | 分享 | 课程版本 5.7
kiyoma
配置里的'database' => 0 是什么意思?
0 个点赞 | 2 个回复 | 问答 | 课程版本 5.5
mr_zhang
Redis?
0 个点赞 | 1 个回复 | 问答 | 课程版本 5.6
蜡笔小新
为什么我用 phpredis,设置 read_timeout 等于-1,报错
0 个点赞 | 0 个回复 | 问答 | 课程版本 5.7