Laravel为不同的缓存系统提供了统一的API。缓存配置位于config/cache.php
。在该文件中你可以指定在应用中默认使用哪个缓存驱动。Laravel目前支持流行的缓存后端如Memcached和Redis等。
缓存配置文件还包含其他文档化的选项,确保仔细阅读这些选项。默认情况下,Laravel被配置成使用文件缓存,这会将序列化数据和缓存对象存储到文件系统。对大型应用,建议使用内存缓存如Memcached或APC,你甚至可以为同一驱动配置多个缓存配置。
使用database
缓存驱动时,你需要设置一张表包含缓存缓存项。下面是该表的Schema
声明:
Schema::create('cache', function($table) {
$table->string('key')->unique();
$table->text('value');
$table->integer('expiration');
});
使用Memcached缓存要求安装了Memcached PECL 包,即PHP Memcached扩展。
Memcached::addServer默认配置使用TCP/IP协议:
'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
],
],
使用Laravel的Redis缓存之前,你需要通过Composer安装predis/predis
包(~1.0)。
了解更多关于Redis的配置,查看Larave的Redis文档。
Illuminate\Contracts\Cache\Factory
和Illuminate\Contracts\Cache\Repository
契约提供了访问Laravel的缓存服务的方法。Factory
契约提供了所有访问应用定义的缓存驱动的方法。Repository
契约通常是应用中cache
配置文件中指定的默认缓存驱动的一个实现。
然而,你还可以使用Cache
门面,这也是我们在整个文档中使用的方式,Cache
门面提供了简单方便的方式对底层Laravel缓存契约实现进行访问。
例如,让我们在控制器中导入Cache
门面:
<?php
namespace App\Http\Controllers;
use Cache;
use Illuminate\Routing\Controller;
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);
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')) {
//
}
increment
和decrement
方法可用于调整缓存中的整型数值。这两个方法都可以接收第二个参数来指明缓存项数值增加和减少的数目:
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
方法的闭包被执行并且将结果存放到缓存中。
你还可以联合remember
和forever
方法:
$value = Cache::rememberForever('users', function() {
return DB::table('users')->get();});
如果你需要从缓存中获取缓存项然后删除,你可以使用pull
方法,和get
方法一样,如果缓存项不存在的话返回null:
$value = Cache::pull('key');
你可以使用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');
你可以使用Cache
门面上的forget
方法从缓存中移除缓存项:
Cache::forget('key');
要使用自定义驱动扩展Laravel缓存,我们使用Cache
门面的extend
方法,该方法用于绑定定义驱动解析器到管理器,通常,这可以在服务提供者中完成。
例如,要注册一个新的命名为“mongo”的缓存驱动:
<?php
namespace App\Providers;
use Cache;
use App\Extensions\MongoStore;
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
实例的闭包。该闭包中被传入一个$app
实例,也就是服务容器的一个实例。
调用Cache::extend
可以在默认App\Providers\AppServiceProvider
中的boot
方法中完成,或者你也可以创建自己的服务提供者来存放该扩展——只是不要忘了在配置文件config/app.php
中注册该提供者。
要创建自定义的缓存驱动,首先需要实现Illuminate\Contracts\Cache\Store
契约,所以,我们的MongoDB
缓存实现看起来像这样子:
<?php
namespace App\Extensions;
class MongoStore implements \Illuminate\Contracts\Cache\Store{
public function get($key) {}
public function put($key, $value, $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
连接实现每一个方法,实现完成后,我们可以完成自定义驱动注册:
Cache::extend('mongo', function($app) {
return Cache::repository(new MongoStore);
});
扩展完成后,只需要更新配置文件config/cache.php
的driver
选项为你的扩展名称。
如果你在担心将自定义缓存驱动代码放到哪,考虑将其放到Packgist!或者,你可以在app
目录下创建一个Extensions
命名空间。然而,记住Laravel并没有一个严格的应用目录结构,你可以基于你的需要自由的组织目录结构。
注意:缓存标签不支持
file
或database
缓存驱动,此外,在“永久”存储缓存中使用多个标签时,memcached
之类的驱动有着最佳性能,因为它可以自动清除过期的记录。
缓存标签允许你给相关的缓存项打上同一个标签,然后可以输出被分配同一个标签的所有缓存值。你可以通过传递一个有序的标签名数组来访问被打上标签的缓存。例如,让我们访问一个被打上标签的缓存并将其值放到缓存中:
Cache::tags(['people', 'artists'])->put('John', $john, $minutes);
Cache::tags(['people', 'authors'])->put('Anne', $anne, $minutes);
然而,并不只限于使用put
方法,你可以在处理标签时使用任何混存存储器提供的方法。
要获取被打上标签的缓存项,传递同样的有序标签名数组到tags
方法:
$john = Cache::tags(['people', 'artists'])->get('John');
$anne = Cache::tags(['people', 'authors'])->get('Anne');
通过上面的语句你可以输出所有分配了该标签或标签列表的缓存项,例如,下面这个语句将会移除被打上people
,authors
标签的缓存,或者,Anne
和 John
都会从缓存中移除:
Cache::tags(['people', 'authors'])->flush();
相比之下,下面这个语句只会移除被打上 authors
标签的缓存,所以Anne
会被移除,而John
不会:
Cache::tags('authors')->flush();
要在每次缓存操作时执行代码,你可以监听缓存触发的事件,通常,你可以将这些缓存处理器代码放到EventServiceProvider
的boot
方法中:
/**
* 注册应用任意其他事件
*
* @param \Illuminate\Contracts\Events\Dispatcher $events
* @return void
*/
public function boot(DispatcherContract $events){
parent::boot($events);
$events->listen('cache.hit', function ($key, $value) {
//
});
$events->listen('cache.missed', function ($key) {
//
});
$events->listen('cache.write', function ($key, $value, $minutes) {
//
});
$events->listen('cache.delete', function ($key) {
//
});
}
扩展阅读1:实例教程(一) —— 基于Memcached缓存驱动的配置
扩展阅读2:实例教程(二)—— 基于模型+缓存对文章增删改查进行优化