Wallogit.com
2017 © Pedro Peláez
Russian Doll Caching for Laravel.
Matryoshka is a package for Laravel that provides Russian-Doll caching for your view logic., (*1)
Want to learn how this exact package was made from scratch? See Laracasts.com., (*2)
From the command line, run:, (*3)
composer require laracasts/matryoshka
For your Laravel app, open config/app.php and, within the providers array, append:, (*4)
Laracasts\Matryoshka\MatryoshkaServiceProvider::class
This will bootstrap the package into Laravel., (*5)
For this package to function properly, you must use a Laravel cache driver that supports tagging (like Cache::tags('foo')). Drivers such as Memcached and Redis support this feature., (*6)
Check your .env file, and ensure that your CACHE_DRIVER choice accomodates this requirement:, (*7)
CACHE_DRIVER=memcached
Have a look at Laravel's cache configuration documentation, if you need any help., (*8)
With the package now installed, you may use the provided @cache Blade directive anywhere in your views, like so:, (*9)
@cache('my-cache-key')
<div>
<h1>Hello World</h1>
</div>
@endcache
By surrounding this block of HTML with the @cache and @endcache directives, we're asking the package to cache the given HTML. Now this example is trivial, however, you can imagine a more complex view that includes various nested caches, as well as lazy-loaded relationship calls that trigger additional database queries. After the initial page load that caches the HTML fragment, each subsequent refresh will instead pull from the cache. As such, those additional database queries will never be executed., (*10)
Please keep in mind that, in production, this will cache the HTML fragment "forever." For local development, on the other hand, we'll automatically flush the relevant cache for you each time you refresh the page. That way, you may update your views and templates however you wish, without needing to worry about clearing the cache manually., (*11)
Now because your production server will cache the fragments forever, you'll want to add a step to your deployment process that clears the relevant cache., (*12)
Cache::tags('views')->flush();
While you're free to hard-code any string for the cache key, the true power of Russian-Doll caching comes into play when we use a timestamp-based approach., (*13)
Consider the following fragment:, (*14)
@cache($post)
<article>
<h2>{{ $post->title }}></h2>
<p>Written By: {{ $post->author->username }}</p>
<div class="body">{{ $post->body }}</div>
</article>
@endcache
In this example, we're passing the $post object, itself, to the @cache directive - rather than a string. The package will then look for a getCacheKey() method on the model. We've already done that work for you; just have your Eloquent model use the Laracasts\Matryoshka\Cacheable trait, like so:, (*15)
use Laracasts\Matryoshka\Cacheable;
class Post extends Eloquent
{
use Cacheable;
}
Alternatively, you may use this trait on a parent class that each of your Eloquent models extend., (*16)
That should do it! Now, the cache key for this fragment will include the object's id and updated_at timestamp: App\Post/1-13241235123., (*17)
The key is that, because we factor the
updated_attimestamp into the cache key, whenever you update the given post, the cache key will change. This will then, in effect, bust the cache!, (*18)
In order for this technique to work properly, it's vital that we have some mechanism to alert parent relationships (and subsequently bust parent caches) each time a model is updated. Here's a basic workflow:, (*19)
updated_at timestamp is refreshed, triggering a new cache key for the instance.updated_at timestamp, too, is updated, which busts its associated cache.Luckily, Laravel offers this "touch" functionality out of the box. Consider a Note object that needs to alert its parent Card relationship each time an update occurs., (*20)
<?php
namespace App;
use Laracasts\Matryoshka\Cacheable;
use Illuminate\Database\Eloquent\Model;
class Note extends Model
{
use Cacheable;
protected $touches = ['card'];
public function card()
{
return $this->belongsTo(Card::class);
}
}
Notice the $touches = ['card'] portion. This instructs Laravel to ping the card relationship's timestamps each time the note is updated., (*21)
Now, everything is in place. You might render your view, like so:, (*22)
resources/views/cards/_card.blade.php, (*23)
@cache($card)
<article class="Card">
<h2>{{ $card->title }}</h2>
<ul>
@foreach ($card->notes as $note)
@include ('cards/_note')
@endforeach
</ul>
</article>
@endcache
resources/views/cards/_note.blade.php, (*24)
@cache($note)
<li>{{ $note->body }}</li>
@endcache
Notice the Russian-Doll style cascading for our caches; that's the key. If any note is updated, its individual cache will clear - along with its parent - but any siblings will remain untouched., (*25)
You won't always want to cache model instances; you may wish to cache a Laravel collection as well! No problem., (*26)
@cache($posts)
@foreach ($posts as $post)
@include ('post')
@endforeach
@endcache
Now, as long as the $posts collection contents does not change, that @foreach section will never run. Instead, as always, we'll pull from the cache., (*27)
Behind the scenes, this package will detect that you've passed a Laravel collection to the cache directive, and will subsequently generate a unique cache key for the collection., (*28)
1. Is there any way to override the cache key for a model instance?, (*29)
Yes. Let's say you have:, (*30)
@cache($post)
<div>view here</div>
@endcache
Behind the scenes, we'll look for a getCacheKey method on the model. Now, as mentioned above, you can use the Laracasts\Matryoshka\Cacheable trait to instantly import this functionality. Alternatively, you may pass a second argument to the @cache directive, like this:, (*31)
@cache($post, 'my-custom-key')
<div>view here</div>
@endcache
This instructs the package to use my-custom-key for the cache instead. This can be useful for pagination and other related tasks., (*32)
2. Where can I learn more about this approach to caching?, (*33)
Give these two articles a read:, (*34)
And, if you enjoy Laracasts, watch the creation of this package from scratch here., (*35)
Russian Doll Caching for Laravel.
MIT
laravel cache
Russian Doll Caching for Laravel.
MIT
laravel cache
Russian Doll Caching for Laravel.
MIT
laravel cache