julienmru / laravel-partialcache
Blade directive to cache rendered partials in laravel
Requires
- php: >=7.2.5
Requires (Dev)
- phpunit/phpunit: 4.*
- scrutinizer/ocular: ~1.1
This package is auto-updated.
Last update: 2024-10-20 09:09:34 UTC
README
🚨 THIS PACKAGE HAS BEEN ABANDONED 🚨
We don't use this package anymore in our own projects and cannot justify the time needed to maintain it anymore. That's why we have chosen to abandon it. Feel free to fork our code and maintain your own copy.
Laravel Cache Partial Blade Directive
This package provides a Blade directive for Laravel >=5.1 to cache rendered partials in Laravel.
Install
You can install the package via Composer:
$ composer require julienmru/laravel-partialcache
In Laravel 5.5 the package's service provider and facade will be registered automatically. In older versions of Laravel, you must register them manually:
// config/app.php 'providers' => [ ... JulienMru\PartialCache\PartialCacheServiceProvider::class, ], 'aliases' => [ ... 'PartialCache' => JulienMru\PartialCache\PartialCacheFacade::class, ],
The facade is optional, but the rest of this guide assumes you're using it.
Publish the config files:
$ php artisan vendor:publish --provider="JulienMru\PartialCache\PartialCacheServiceProvider"
Usage
The package registers a blade directive, @cache
. The cache directive accepts the same arguments as @include
, plus optional parameters for the amount of minutes a view should be cached for, a key unique to the rendered view, and a cache tag for the rendered view. If no minutes are provided, the view will be remembered until you manually remove it from the cache.
Note that this caches the rendered html, not the rendered php like blade's default view caching.
{{-- Simple example --}}
@cache('footer.section.partial')
{{-- With extra view data --}}
@cache('products.card', ['product' => $category->products->first()])
{{-- For a certain time --}}
{{-- (cache will invalidate in 60 minutes in this example, set null to remember forever) --}}
@cache('homepage.news', null, 60)
{{-- With an added key (cache entry will be partialcache.user.profile.{$user->id}) --}}
@cache('user.profile', null, null, $user->id)
{{-- With an added tag (only supported by memcached and others) }}
@cache('user.profile', null, null, $user->id, 'userprofiles')
{{-- With array of tags (only supported by memcached and others) }}
@cache('user.profile', null, null, $user->id, ['user', 'profile', 'location'])
Clearing The PartialCache
You can forget a partialcache entry with PartialCache::forget($view, $key)
.
PartialCache::forget('user.profile', $user->id);
If you have used @cache on an entry along with tags and your cache driver supports them (like memcached and other), you need to use the same tags to forget the entry.
// With an added tag PartialCache::forget('user.profile', $user->id, 'userprofiles'); // With array of tags PartialCache::forget('user.profile', $user->id, ['user', 'profile', 'location']);
If you want to flush all entries, you'll need to either call PartialCache::flush()
(note: this is only supported by drivers that support tags), or clear your entire cache.
Configuration
Configuration isn't necessary, but there are environement variables you can use:
PARTIAL_CACHE_ENABLED
: Fully enable or disable the cache. Defaults totrue
.PARTIAL_CACHE_DIRECTIVE
: The name of the blade directive to register. Defaults tocache
.PARTIAL_CACHE_KEY
: The base key that used for cache entries. Defaults topartialcache
.PARTIAL_CACHE_DEFAULT_DURATION
: The default cache duration in minutes, setnull
to remember forever. Defaults tonull
.PARTIAL_CACHE_DRIVER
: The cache store that should be used to store requests. Defaults tofile
.
Change log
Please see CHANGELOG for more information what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security
If you discover any security related issues, please email freek@spatie.be instead of using the issue tracker.
Postcardware
You're free to use this package, but if it makes it to your production environment we highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using.
Our address is: Spatie, Samberstraat 69D, 2060 Antwerp, Belgium.
We publish all received postcards on our company website.
Credits
Support us
Spatie is a webdesign agency based in Antwerp, Belgium. You'll find an overview of all our open source projects on our website.
Does your business depend on our contributions? Reach out and support us on Patreon. All pledges will be dedicated to allocating workforce on maintenance and new awesome stuff.
License
The MIT License (MIT). Please see License File for more information.