[ Laravel 5.4 文档 ] 综合话题 —— 缓存
来源:互联网 发布:macbookpro如何装软件 编辑:程序博客网 时间:2024/05/23 01:28
1、配置
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');});
注:你还可以使用 Artisan 命令
php artisan cache:table
通过相应的 schema 生成迁移。
Memcached
使用 Memcached 缓存要求安装了Memcached PECL 包,即 PHP Memcached扩展。你可以在配置文件 config/cache.php
中列出所有 Memcached 服务器:
'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
使用 Laravel 的 Redis 缓存之前,你需要通过 Composer 安装 predis/predis
包(~1.0)。
想要了解更多关于 Redis 的配置,查看Larave 的 Redis 文档。
2、缓存使用
获取缓存实例
Illuminate\Contracts\Cache\Factory
和Illuminate\Contracts\Cache\Repository
契约提供了访问 Laravel 缓存服务的方法。Factory
契约提供了所有访问应用定义的缓存驱动的方法。Repository
契约通常是应用中cache
配置文件中指定的默认缓存驱动的一个实现。
不过,你还可以使用 Cache
门面,这也是我们在整个文档中使用的方式,Cache
门面提供了简单方便的方式对底层 Laravel 缓存契约实现进行访问:
<?phpnamespace App\Http\Controllers;use Illuminate\Support\Facades\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);
从缓存中获取数据
Cache
门面的 get
方法用于从缓存中获取缓存项,如果缓存项不存在,返回 null
。如果需要的话你可以传递第二个参数到get
方法指定缓存项不存在时返回的自定义默认值:
$value = Cache::get('key');$value = Cache::get('key', 'default');
你甚至可以传递一个闭包作为默认值,如果缓存项不存在的话闭包的结果将会被返回。传递闭包允许你可以从数据库或其它外部服务获取默认值:
$value = Cache::get('key', function() { return DB::table(...)->get();});
检查缓存项是否存在
has
方法用于判断缓存项是否存在,如果值为 null
或 false
该方法会返回false
:
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');
注:如果你使用的是 Memcached 驱动,当缓存数据达到上限后永久存储的数据就会被移除。
从缓存中移除数据
你可以使用 Cache
门面上的 forget
方法从缓存中移除缓存项数据:
Cache::forget('key');
还可以使用 flush
方法清除所有缓存:
Cache::flush();
注:清除缓存并不管什么缓存键前缀,而是从缓存系统中移除所有数据,所以在使用这个方法时如果其他应用与本应用有共享缓存时需要格外注意。
缓存辅助函数
除了使用 Cache
门面或缓存契约,还可以使用全局的cache
函数来通过缓存获取和存储数据。当带有一个字符串参数的 cache
函数被调用时,会返回给定键对应的缓存值(取值):
$value = cache('key');
如果你提供了键值对数组和一个过期时间给该函数,则会在指定的有效期内存储缓存值(存储):
cache(['key' => 'value'], $minutes);cache(['key' => 'value'], Carbon::now()->addSeconds(10));
测试调用
cache
函数时,可以像测试门面一样使用Cache::shouldReceive
方法。
3、缓存标签
注:缓存标签目前不支持
file
或database
缓存驱动,此外,当使用多标签的缓存被设置为永久存储时,使用memcached
驱动的缓存有着最佳性能表现,因为 Memcached 会自动清除陈旧记录。
存储被打上标签的缓存项
缓存标签允许你给相关缓存项打上同一个标签以便于后续清除这些缓存值,被打上标签的缓存可以通过传递一个被排序的标签数组来访问。例如,我们可以通过以下方式在添加缓存的时候设置标签:
Cache::tags(['people', 'artists'])->put('John', $john, $minutes);Cache::tags(['people', 'authors'])->put('Anne', $anne, $minutes);
你可以给多个缓存项打上相同标签,这是没有数目限制的。
访问被打上标签的缓存项
要获取被打上标签的缓存项,传递同样的有序标签数组到 tags
方法然后使用你想要获取的key来调用 get
方法:
$john = Cache::tags(['people', 'artists'])->get('John');$anne = Cache::tags(['people', 'authors'])->get('Anne');
移除被打上标签的数据项
你可以同时清除被打上同一标签/标签列表的所有缓存项,例如,以下语句会移除被打上 people
或 authors
标签的所有缓存:
Cache::tags(['people', 'authors'])->flush();
这样,上面设置的 Anne
和 John
缓存项都会从缓存中移除。
相反,以下语句只移除被打上 authors
标签的语句,所以只有 Anne
会被移除而 John
不会:
Cache::tags('authors')->flush();
4、添加自定义缓存驱动
编写驱动
要创建自定义的缓存驱动,首先需要实现 Illuminate\Contracts\Cache\Store
契约,所以,我们的 MongoDB 缓存实现看起来会像这样子:
<?phpnamespace 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 连接来实现其中的每一个方法,想要看如何实现每个方法的示例,可以参考 Laravel 底层源码 Illuminate\Cache\MemcachedStore
,实现完成后,我们就可以完成自定义驱动注册:
Cache::extend('mongo', function($app) { return Cache::repository(new MongoStore);});
注:如果你在担心将自定义缓存驱动代码放到哪,可以在
app
目录下创建一个Extensions
命名空间。不过,记住 Laravel 并没有一个严格的应用目录结构,你可以基于你的需要自由的组织目录结构。
注册驱动
要通过 Laravel 注册自定义的缓存驱动,可以使用 Cache
门面上的extend
方法。对 Cache::extend
的调用可以在 Laravel 自带的 App\Providers\AppServiceProvider
提供的boot
方法中完成,或者,你也可以创建自己的服务提供者来存放扩展——只是别忘了在配置文件 config/app.php
中注册服务提供者到providers
数组:
<?phpnamespace 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 * @translator laravelacademy.org */ 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
实例,也就是服务容器的一个实例。
扩展被注册后,只需简单更新配置文件config/cache.php
的 driver
选项为自定义扩展名称即可。
5、缓存事件
要在每次缓存操作时执行代码,你可以监听缓存触发的事件,通常,你可以将这些缓存处理器代码放到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', ],];
- [ Laravel 5.4 文档 ] 综合话题 —— 缓存
- [ Laravel 5.4 文档 ] 综合话题 —— 辅助函数
- [ Laravel 5.2 文档 ] 服务 —— 缓存
- laravel 基础教程 —— 缓存
- 通俗话题—人生
- ROS6—理解话题
- laravel缓存
- 关于缓存的话题
- ATS缓存相关话题
- Laravel 5.4 官方文档摘记:Laravel操作数据库
- Laravel 5.4 官方文档摘记:路由
- Laravel 5.4 官方文档摘记:中间件
- Laravel 5.4 官方文档摘记:CSRF保护
- Laravel 5.4 官方文档摘记:控制器
- Laravel 5.4 官方文档摘记:请求实例
- Laravel 5.4 官方文档摘记:响应
- Laravel 5.4 官方文档摘记:View类
- Laravel 5.4 官方文档摘记:验证
- Android零基础入门第40节:自定义ArrayAdapter
- java.util.ConcurrentModificationException
- 在linux上安装 elasticsearch-php
- 特征类文献---LBP的衍化之道就能创作一篇优秀的文章
- ELasticSearch 深入理解系列5 -索引、类型
- [ Laravel 5.4 文档 ] 综合话题 —— 缓存
- poj-3295-Tautology
- 奶牛喝水最少需要的交换次数
- 双拼输入法使用经验
- 使用任意数量的关键字实参
- 模拟实现僵尸进程和孤儿进程
- 区域存储网络(SAN)与 网络直接存储(NAS)
- 【手把手教你全文检索】Apache Lucene初探
- ElasticSearch-深入理解系列6 -文档操作