[ Lumen 5.1 文档 ] 更多特性 —— 缓存

1、配置

Lumen为不同的缓存系统提供了统一的API。缓存配置项位于env文件。在该文件中你可以指定在应用中默认使用哪个缓存驱动。Lumen目前支持流行的缓存后端如MemcachedRedis等。对于大型应用,推荐使用内存缓存如Memcached或APC。

1.1 缓存预备知识

数据库

使用database缓存驱动时,你需要设置一张表包含缓存缓存项。下面是该表的Schema声明:

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

Memcached

使用Memcached缓存要求安装了Memcached PECL 包,即PHP Memcached扩展。Memcached::addServer默认配置使用TCP/IP协议。

Redis

在Lumen中使用Redis缓存之前,你需要通过Composer安装predis/predis包(~1.0)和illuminate/redis包(~5.1)。

2、缓存使用

2.1 获取缓存实例

Illuminate\Contracts\Cache\FactoryIlluminate\Contracts\Cache\Repository契约提供了访问Laravel的缓存服务的方法。Factory契约提供了所有访问应用定义的缓存驱动的方法。Repository契约通常是应用中cache配置文件中指定的默认缓存驱动的一个实现。

然而,你还可以使用Cache门面,这也是我们在整个文档中使用的方式,Cache门面提供了简单方便的方式对底层Lumen缓存契约实现进行访问。

例如,让我们在控制器中导入Cache门面:

<?php

namespace App\Http\Controllers;

use Cache;

class UserController extends Controller{
    /**
     * 显示应用所有用户列表
     *
     * @return Response
     */
    public function index()
    {
        $value = Cache::get('key');

        //
    }
}

访问多个缓存存储

使用Cache门面,你可以使用store方法访问不同的缓存存储器,传入store方法的键就是cache配置文件中stores配置数组里列出的相应的存储器:

$value = Cache::store('file')->get('foo');
Cache::store('redis')->put('bar', 'baz', 10);

2.2 从缓存中获取数据

Cache门面的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')) {
    //
}

数值增加/减少

incrementdecrement方法可用于调整缓存中的整型数值。这两个方法都可以接收第二个参数来指明缓存项数值增加和减少的数目:

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方法的闭包被执行并且将结果存放到缓存中。

你还可以联合rememberforever方法:

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

获取并删除

如果你需要从缓存中获取缓存项然后删除,你可以使用pull方法,和get方法一样,如果缓存项不存在的话返回null:

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

2.3 存储缓存项到缓存

你可以使用Cache 门面上的put方法在缓存中存储缓存项。当你在缓存中存储缓存项的时候,你需要指定数据被缓存的时间(分钟数):

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

除了传递缓存项失效时间,你还可以传递一个代表缓存项有效时间的PHP 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');

2.4 从缓存中移除数据

你可以使用Cache门面上的forget方法从缓存中移除缓存项:

Cache::forget('key');

学院君

学院君 has written 550 articles

资深PHP工程师,Laravel学院院长