library laravel-httpcache

shawnley/laravel-httpcache

HttpCache for Laravel 5

HttpCache for Laravel 5

For Laravel 4.1+, require v0.1.x

Laravel 5 can use HttpKernelInterface Middlewares, so also HttpCache. This package provides a simple ServiceProvider to get you started with HttpCache., _(*1)

First, require this package in composer.json and run composer update, _(*2)

"barryvdh/laravel-httpcache": "0.2.x@dev"

After updating, add the ServiceProvider to the array of providers in app/config/app.php, _(*3)

'Barryvdh\HttpCache\ServiceProvider',

You can now add the Middleware to your Kernel:, _(*4)

'Barryvdh\HttpCache\Middleware\CacheRequests',

Caching is now enabled, for public responses. Just set the Ttl or MaxSharedAge, _(*5)

Route::get('my-page', function(){
   return Response::make('Hello!')->setTtl(60); // Cache 1 minute
});

You can also define a filter., _(*6)

Route::filter('cache', function($route, $request, $response, $age=60){
    $response->setTtl($age);
});
Route::get('cached', array('after' => 'cache:30', function(){
    return 'I am cached 30 seconds!';
}));

Publish the config to change some options (cache dir, default ttl, etc) or enable ESI., _(*7)

$ php artisan vendor:publish --provider="Barryvdh\HttpCache\ServiceProvider"

ESI

Enable ESI in your config file and add the Esi Middleware to your Kernel:, _(*8)

'Barryvdh\HttpCache\Middleware\ParseEsi',

You can now define ESI includes in your layouts., _(*9)

<esi:include src="<?= url('partial/page') ?>"/>

This will render partial/page, with it's own TTL. The rest of the page will remain cached (using it's own TTL), _(*10)

Purging/flushing the cache

You can purge a single url or just delete the entire cache directory:, _(*11)

App::make('http_cache.store')->purge($url);
\File::cleanDirectory(app('http_cache.cache_dir'));

Or use the Artisan httpcache:clear command, _(*12)

$ php artisan httpcache:clear

More information

For more information, read the Docs on Symfony HttpCache, _(*13)