缓存系统

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

缓存

配置信息

Laravel 给多种缓存系统提供丰富而统一的 API,缓存配置信息位于 config/cache.php,在这个文件中你可以为你的应用程序指定默认的缓存驱动,Laravel 支持当前流行的缓存系统,如非常棒的 MemcachedRedis

缓存配置信息文件中也包括很多其他选项,你可以在文件中找到这些选项,请确保你看过这些选项说明。Laravel 默认使用将序列化缓存对象保存在文件系统中的 file 缓存驱动,对于大型应用程序而言,推荐你使用如 Memcached 或者 Redis 这样更强大的缓存驱动。你甚至可以为一个驱动配置多个缓存配置信息。

驱动前提条件

数据库

当使用 database 缓存驱动时,你需要配置一个用来存放缓存项的数据库表,下面是一个 Schema 数据表结构声明的示例:

Schema::create('cache', function($table) {
    $table->string('key')->unique();
    $table->text('value');
    $table->integer('expiration');
});

{tip} 你也可以使用 php artisan cache:table 这个 Artisan 命令生成一个有合适数据表结构的 migration 。

Memcached

使用 Memcached 驱动需要安装 Memcached PECL 扩展包 。你可以把所有 Memcached 服务器都列在 config/cache.php 这个配置信息文件中:

'memcached' => [
    [
        'host' => '127.0.0.1',
        'port' => 11211,
        'weight' => 100
    ],
],

你也可以把 host 选项配置到 UNIX 的 socket 路径中。如果你这样配置了,port 选项应该设置为 0

'memcached' => [
    [
        'host' => '/var/run/memcached/memcached.sock',
        'port' => 0,
        'weight' => 100
    ],
],

Redis

在使用 Redis 作为 Laravel 的缓存驱动前,你需要通过 Composer 安装 predis/predis 扩展包 (~1.0) 。
关于配置 Redis 的更多信息,请参考 Laravel 文档页面

缓存的使用

获取一个缓存实例

Illuminate\Contracts\Cache\FactoryIlluminate\Contracts\Cache\Repository contracts 提供了访问 Laravel 缓存服务的机制。Factory contract 则为你的应用程序定义了访问所有缓存驱动的机制。Repository contract 是典型的用 cache 配置信息文件指定你的应用程序默认缓存驱动的实现。

然而,你也可以使用 Cache facade,我们将在文档的后续中介绍。Cache facade 提供了方便又简洁的方法访问缓存实例:

<?php

namespace App\Http\Controllers;

use Illuminate\Support\Facades\Cache;

class UserController extends Controller
{
    /**
     * Show a list of all users of the application.
     *
     * @return Response
     */
    public function index()
    {
        $value = Cache::get('key');

        //
    }
}

访问多个缓存仓库

使用Cache facade,可通过 store 方法来访问缓存仓库,传入 store 方法的键应该对应一个缓存配置信息文件中的 stores 配置信息数组中列出的配置值:

$value = Cache::store('file')->get('foo');

Cache::store('redis')->put('bar', 'baz', 10);

从缓存中获取项目

Cache facade 中的 get 方法用来从缓存中获取缓存项,如果缓存中不存在该缓存项,返回 null 。你也可以向 get 方法传递第二个参数,用来指定缓存项不存在时返回的默认值:

$value = Cache::get('key');

$value = Cache::get('key', 'default');

你甚至可以将 闭包 作为默认值传递。如果指定的缓存项在缓存中不存在,闭包 的结果将被返回。传递一个闭包允许你延迟从数据库或外部服务中取出默认值:

$value = Cache::get('key', function() {
    return DB::table(...)->get();
});

确认项目是否存在

has 方法可以用来检查一个项目是否存在于缓存中:

if (Cache::has('key')) {
    //
}

递增与递减值

递增递减 方法可以用来调整缓存中整数项目值。这两个方法都可以传入一个可选的第二个参数,用来指示要递增或递减多少值:

Cache::increment('key');
Cache::increment('key', $amount);
Cache::decrement('key');
Cache::decrement('key', $amount);

获取和更新

有时你可能会想从缓存中取出一个项目,但也想在取出的项目不存在时存入一个默认值,例如,你可能会想从缓存中取出所有用户,或者当用户不存在时,从数据库中将这些用户取出并放入缓存中,你可以使用 Cache::remember 方法实现:

$value = Cache::remember('users', $minutes, function() {
    return DB::table('users')->get();
});

如果缓存项在缓存中不存在,则返回给 remember 方法的闭包将会被运行,而且闭包的运行结果将会被存放在缓存中。

获取和删除

如果你需要从缓存中获取一个缓存项然后删除它,你可以使用 pull 方法。像 get 方法一样,如果缓存项在缓存中不存在,null 将被返回:

$value = Cache::pull('key');

存储项目到缓存中

你可以使用 Cache facade 的 put 方法来存放缓存项到缓存中,当你在缓存中存放缓存项时,你需要使用第三个参数来设定缓存的存放时间:

Cache::put('key', 'value', $minutes);

如果要指定一个缓存项过期的分钟数,你也可以传递一个 DateTime 实例来表示该缓存项过期的时间点:

$expiresAt = Carbon::now()->addMinutes(10);

Cache::put('key', 'value', $expiresAt);

写入目前不存在的项目

add 方法只会把暂时不存在于缓存中的缓存项放入缓存,如果存放成功将返回 true ,否则返回 false

Cache::add('key', 'value', $minutes);

永久写入项目

forever 方法可以用来将缓存项永久存入缓存中,因为这些缓存项不会过期,所以必须通过 forget 方法手动删除:

Cache::forever('key', 'value');

{tip} 如果你在使用 Memcached 驱动,那么当缓存达到大小限制时,那些「永久」保存的缓存项可能被移除。

从缓存中移除项目

你可以使用 forget 方法从缓存中移除一个项目:

Cache::forget('key');

也可以使用 flush 方法清空所有缓存:

Cache::flush();

{note} 清空缓存并不会遵从缓存的前缀,并且会将缓存中所有的缓存项删除。在清除与其它应用程序共享的缓存时应谨慎考虑这一点。

缓存标签

{note} 缓存标签并不支持使用 filedababase 的缓存驱动。此外,当在缓存使用多个标签并「永久」写入时,类似 memcached 的驱动性能会是最佳的,且会自动清除旧的纪录。

写入被标记的缓存项

缓存标签允许你在缓存中标记关联的项目,并清空所有已分配指定标签的缓存值。你可以通过传入一组标签名称的有序数组,以访问被标记的缓存。举例来说,让我们访问一个被标记的缓存并 put 值给它:

Cache::tags(['people', 'artists'])->put('John', $john, $minutes);

Cache::tags(['people', 'authors'])->put('Anne', $anne, $minutes);

访问被标记的缓存项

若要获取一个被标记的缓存项,只要传递一样的有序标签列表至 tags 方法,然后通过你希望获取的值对应的键来调用 get 方法:

$john = Cache::tags(['people', 'artists'])->get('John');

$anne = Cache::tags(['people', 'authors'])->get('Anne');

移除被标记的缓存项

你可以清空已分配的单个标签或是一组标签列表中的所有缓存项。例如,下方的语句会把被标记为 peopleauthors,或两者都标记了的缓存都移除。所以,AnneJohn 都会被从缓存中移除:

Cache::tags(['people', 'authors'])->flush();

相反的,下方的语句只会删除被标示为 authors 的缓存,所以 Anne 会被移除,但 John 不会:

Cache::tags('authors')->flush();

增加自定义的缓存驱动

写驱动

为了创建自定义的缓存驱动,首先我们需要部署 Illuminate\Contracts\Cache\Store contract 。所以 MongoDB 缓存实现看起来会像这样:

<?php

namespace App\Extensions;

use Illuminate\Contracts\Cache\Store;

class MongoStore implements Store
{
    public function get($key) {}
    public function many(array $keys);
    public function put($key, $value, $minutes) {}
    public function putMany(array $values, $minutes);
    public function increment($key, $value = 1) {}
    public function decrement($key, $value = 1) {}
    public function forever($key, $value) {}
    public function forget($key) {}
    public function flush() {}
    public function getPrefix() {}
}

我们只需要通过一个 MongoDB 的连接来实现这些方法。关于如何实现这些方法,可以查看框架源代码中的 Illuminate\Cache\MemcachedStore 。一旦我们的部署完成,我们就可以完成自定义驱动的注册了。

Cache::extend('mongo', function($app) {
    return Cache::repository(new MongoStore);
});

{tip} 如果你想知道把自定义的缓存驱动代码放置在哪里,你可以在 app 目录下创建一个 Extensions 命名空间。Laravel 没有硬性规定应用程序的结构,你可以依照你的喜好任意组织你的应用程序。

注册驱动

通过 Laravel 注册自定义缓存驱动,我们将用到 Cache facade 的 extend 方法。Cache::extend 的调用会在最新的 Laravel 应用程序默认的 App\Providers\AppServiceProviderboot 方法中完成。或者你可以创建你自己的服务提供者来放置这些扩展 - 不要忘记在 config/app.php 提供者数组中注册提供者:

<?php

namespace App\Providers;

use App\Extensions\MongoStore;
use Illuminate\Support\Facades\Cache;
use Illuminate\Support\ServiceProvider;

class CacheServiceProvider extends ServiceProvider
{
    /**
     * Perform post-registration booting of services.
     *
     * @return void
     */
    public function boot()
    {
        Cache::extend('mongo', function($app) {
            return Cache::repository(new MongoStore);
        });
    }

    /**
     * Register bindings in the container.
     *
     * @return void
     */
    public function register()
    {
        //
    }
}

传递给 extend 方法的第一个参数是驱动名称。这取决于你的 config/cache.php 配置信息文件的 driver 选项。第二个参数为一个应该返回 Illuminate\Cache\Repository 实例的闭包。这个闭包将传递一个 service container$app 实例。

一旦你的扩展被注册,就可以轻松的更新 config/cache.php 配置信息文件的 driver 选项为你的扩展名称。

缓存事件

为了在每一次缓存操作时执行代码,你可以监听缓存触发的事件 事件 。一般来说,你必须将这些事件监听器放置在 EventServiceProvider

/**
 * The event listener mappings for the application.
 *
 * @var array
 */
protected $listen = [
    'Illuminate\Cache\Events\CacheHit' => [
        'App\Listeners\LogCacheHit',
    ],

    'Illuminate\Cache\Events\CacheMissed' => [
        'App\Listeners\LogCacheMissed',
    ],

    'Illuminate\Cache\Events\KeyForgotten' => [
        'App\Listeners\LogKeyForgotten',
    ],

    'Illuminate\Cache\Events\KeyWritten' => [
        'App\Listeners\LogKeyWritten',
    ],
];

译者署名

用户名 头像 职能 签名
@houfei 100 翻译 玩咖啡 & 铲屎奴 & 努力回头做码农 @houfei at Github

{note} 欢迎任何形式的转载,但请务必注明出处,尊重他人劳动共创开源社区。

转载请注明:本文档由 Laravel China 社区 [laravel-china.org] 组织翻译,详见 翻译召集帖

文档永久地址: d.laravel-china.org

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

上一篇 下一篇
《L05 电商实战》
从零开发一个电商项目,功能包括电商后台、商品 & SKU 管理、购物车、订单管理、支付宝支付、微信支付、订单退款流程、优惠券等
《L03 构架 API 服务器》
你将学到如 RESTFul 设计风格、PostMan 的使用、OAuth 流程,JWT 概念及使用 和 API 开发相关的进阶知识。
讨论数量: 2
发起讨论 只看当前版本


king-wang
缓存系统--使用文件缓存怎么删除文件夹和设置过期时间?
0 个点赞 | 5 个回复 | 问答 | 课程版本 8.5
Troy
Cache缓存如何获取key的剩余过期时间?
0 个点赞 | 1 个回复 | 问答 | 课程版本 8.5