[ Laravel 5.7 文档 ] 数据库操作 —— Redis

  发布时间:   文章分类:PHP 浏览数: 13

简介

Redis 是一个开源的、高级的键值对存储系统,经常被用作数据结构服务器,因为其支持 字符串Hash列表集合有序集合 等数据结构。

在 Laravel 中使用 Redis 之前,需要通过 Composer 安装 predis/predis 包:

composer require predis/predis

作为替代方案,你还可以通过 PECL 安装 PHP 扩展 PhpRedis 。该扩展安装起来更麻烦,但是对重度使用 Redis 的应用而言性能更好。

配置

应用的 Redis 配置位于配置文件 config/database.php 。在这个文件中,可以看到包含被应用使用的 Redis 服务器的 redis 数组:

'redis' => [

    'client' => 'predis',

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

],

默认 服务器 配置可以满足开发需要,不过,你可以基于自己的环境修改该数组。配置文件中定义的每个 Redis 服务器需要一个名字并指定该 Redis 服务器使用的主机和接口。

配置集群

如果应用使用了 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 集群,需要在 Redis 配置的 options 中进行指定:

'redis' => [

    'client' => 'predis',

    'options' => [
        'cluster' => 'redis',
    ],

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

],

Predis

除了默认的 hostportdatabasepassword 服务器配置选项,Predis 还支持额外的用于定义每个 Redis 服务器的 连接参数 ,要使用这些额外的配置项,只需在配置文件 config/database.php 中将它们添加到 Redis 服务器配置中:

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

PhpRedis

注:如果你通过 PECL 安装了 PHP 扩展 PhpRedis,需要在配置文件 config/app.php 中重命名 Redis 别名。

要使用 PhpRedis 扩展,需要在Redis 配置中将 client 选项修改为 phpredis ,该选项位于配置文件 config/database

'redis' => [

    'client' => 'phpredis',

    // Rest of Redis configuration...
],

除了默认的 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 交互

你可以通过调用 Redis 门面上的方法来与 Redis 进行交互,该门面支持动态方法,所以你可以调用任何 Redis 命令 ,对应命令将会直接传递给 Redis,在本例中,我们通过调用 Redis 门面上的 get 方法来调用 Redis 上的 GET 命令:

<?php

namespace App\Http\Controllers;

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

class UserController extends Controller{
    /**
     * 显示指定用户属性
     *
     * @param  int  $id
     * @return Response
     * @translator laravelacademy.org
     */
    public function showProfile($id)
    {
        $user = Redis::get('user:profile:'.$id);
        return view('user.profile', ['user' => $user]);
    }
}

当然,如上所述,可以在 Redis 门面上调用任何 Redis 命令。Laravel 使用魔术方法将命令传递给 Redis 服务器,所以只需简单传递参数和 Redis 命令如下:

Redis::set('name', 'Taylor');

$values = Redis::lrange('names', 5, 10);

此外,还可以使用 command 方法传递命令到服务器,该方法接收命令名作为第一个参数,参数值数组作为第二个参数:

$values = Redis::command('lrange', ['name', 5, 10]);

学院君注:如果要使用 Redis 作为缓存驱动,可以参考缓存文档;如果要使用 Redis 作为队列驱动,可以参考队列文档。

使用多个 Redis 连接

你可以通过调用 Redis::connection 方法获取Redis 实例:

$redis = Redis::connection();

这将会获取默认 Redis 服务器实例,你还可以传递服务器名或集群名到 connection 方法来获取 Redis 配置中定义的指定服务器或集群:

$redis = Redis::connection('my-connection');

管道命令

当你需要在一次操作中发送多个命令到服务器的时候应该使用管道, pipeline 方法接收一个参数:接收 Redis 实例的闭包。你可以将所有 Redis 命令发送到这个 Redis 实例,然后这些命令会在一次操作中被执行:

Redis::pipeline(function ($pipe) {
    for ($i = 0; $i < 1000; $i++) {
        $pipe->set("key:$i", $i);
    }
});

发布/订阅

Redis 还提供了调用 Redis 的 publishsubscribe 命令的接口。这些 Redis 命令允许你在给定“频道”监听消息,你可以从另外一个应用发布消息到这个频道,甚至使用其它编程语言,从而允许你在不同的应用/进程之间轻松通信。

首先,让我们使用 subscribe 方法通过 Redis 在一个频道上设置监听器。由于调用 subscribe 方法会开启一个常驻进程,我们将在Artisan 命令中调用该方法:

<?php

namespace App\Console\Commands;

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

class RedisSubscribe extends Command
{
    /**
     * 控制台命令名称
     *
     * @var string
     */
    protected $signature = 'redis:subscribe';

    /**
     * 控制台命令描述
     *
     * @var string
     */
    protected $description = 'Subscribe to a Redis channel';

    /**
     * 执行控制台命令
     *
     * @return mixed
     */
    public function handle()
    {
        Redis::subscribe(['test-channel'], function($message) {
            echo $message;
        });
    }
}

现在,我们可以使用 publish 发布消息到该频道:

Route::get('publish', function () {
    // 路由逻辑...
    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;
});

学院君注:要使用 Redis 作为事件广播服务端,可以参考广播文档。

以上所述就是小编给大家介绍的《[ Laravel 5.7 文档 ] 数据库操作 —— Redis》,希望对大家有所帮助,如果大家有任何疑问请给我留言,小编会及时回复大家的。在此也非常感谢大家对 Coder·码农网 的支持!

码农可能感兴趣的文章:

本文永久链接:www.codercto.com/a/24578.html

文章来源: laravelacademy.org/post/9582.h......

本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们。

相关码农书籍:
The Effective Engineer

The Effective Engineer

Dedmond Lau / The Effective Bookshelf, Palo Alto, CA.

Introducing The Effective Engineer — the only book designed specifically for t...

相关码农工具:
在线进制转换器

在线进制转换器

各进制数互转换器

CSS 压缩/解压工具

CSS 压缩/解压工具

在线压缩/解压 CSS 代码

JSON 在线解析

JSON 在线解析

在线 JSON 格式化工具