README

Cache chunks of your Blade markup with ease.

Installation

You can install the package via Composer:

composer require elfeffe/blade-cache-directive

You can publish the config file with:

php artisan vendor:publish --provider="Elfeffe\BladeCacheDirective\BladeCacheDirectiveServiceProvider" --tag="blade-cache-directive-config"

This is the contents of the published config file:

return [
    'ttl' => 3_600,
];

Usage

This package adds a new @cache Blade directive. It accepts 2 arguments - the cache key and a TTL.

@cache('current_time', 30)
    {{ now() }}
@endcache

When used inside of a Blade template, the content between the 2 directives will be cached using Laravel's application cache. If a TTL (in seconds) isn't provided, the default TTL of 1 hour will be used instead.

If you want to cache the content for a particular model, i.e. a User model, you can use string interpolation to change the key.

@cache("user_profile_{$user->id}")
    {{ $user->name }}
@endcache

When a new user is passed to this view, a separate cache entry will be created.

Tags

The package also supports Laravel's cache tags. You can add tags to your cached content:

@cache('user_profile', null, ['users', 'profiles'])
    {{ $user->name }}
@endcache

This allows you to invalidate specific groups of cached content using Laravel's cache tag functionality:

Cache::tags(['users'])->flush();

Note that cache tags are only available when using cache drivers that support tagging (Redis, Memcached).

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Federico Reggiani
• Ryan Chandler
• All Contributors

License

The MIT License (MIT). Please see License File for more information.