Package Data | |
---|---|
Maintainer Username: | spatie |
Maintainer Contact: | freek@spatie.be (Freek Van der Herten) |
Package Create Date: | 2016-11-04 |
Package Last Update: | 2024-02-29 |
Home Page: | https://freek.dev/663-using-varnish-on-a-laravel-forge-provisioned-server |
Language: | PHP |
License: | MIT |
Last Refreshed: | 2024-11-11 15:22:22 |
Package Statistics | |
---|---|
Total Downloads: | 187,417 |
Monthly Downloads: | 2,898 |
Daily Downloads: | 118 |
Total Stars: | 406 |
Total Watchers: | 8 |
Total Forks: | 44 |
Total Open Issues: | 1 |
This package provides an easy way to work with Varnish 4 (or 5) in Laravel. It provides a route middleware that, when applied to a route, will make sure Varnish will cache the response no matter what. The package also contains a function to flush the Varnish cache from within the application.
We assume that you've already installed Varnish on your server. If not read this blogpost to learn how to install it.
You can install the package via composer:
composer require spatie/laravel-varnish
The package will automatically register itself for Laravel 5.5+.
If you are using Laravel < 5.5, you also need to add Varnish\VarnishServiceProvider
to your config/app.php
providers array:
\Spatie\Varnish\VarnishServiceProvider::class
Next if you use Laravel you must publish the config-file with:
php artisan vendor:publish --provider="Spatie\Varnish\VarnishServiceProvider" --tag="config"
and if you use Lumen, you must copy config/varnish.php
file to your application config folder.
This is the contents of the published file:
return [
/*
* The hostname this Laravel app is listening to.
*/
'host' => 'example.com',
/*
* The location of the file containing the administrative password.
*/
'administrative_secret' => '/etc/varnish/secret',
/*
* The port where the administrative tasks may be sent to.
*/
'administrative_port' => 6082,
/*
* The default amount of minutes that content rendered using the `CacheWithVarnish`
* middleware should be cached.
*/
'cache_time_in_minutes' => 60 * 24,
/*
* The name of the header that triggers Varnish to cache the response.
*/
'cacheable_header_name' => 'X-Cacheable',
];
In the published varnish.php
config file you should set the host
key to the right value.
Add the Spatie\Varnish\Middleware\CacheWithVarnish
middleware to the route middlewares.
For Laravel:
// app/Http/Kernel.php
protected $routeMiddleware = [
...
'cacheable' => \Spatie\Varnish\Middleware\CacheWithVarnish::class,
];
If you are using Lumen, you need to load config file before route middleware definition to your bootstrap/app.php
:
$app->configure('varnish');
$app->routeMiddleware([
...
'cacheable' => \Spatie\Varnish\Middleware\CacheWithVarnish::class,
]);
Finally, you should add these lines to the vcl_backend_response
function in your VCL (by default this is located at /etc/varnish/default.vcl
on your server):
if (beresp.http.X-Cacheable ~ "1") {
unset beresp.http.set-cookie;
}
We highly recommend using the VCL provided the varnish-5.0-configuration-templates repo made by Mattias Geniar.
The routes whose response should be cached should use the cacheable
middleware.
// your routes file
//will be cached by Varnish
Route::group(['middleware' => 'cacheable'], function() {
Route::get('/', 'HomeController@index');
Route::get('/contact', 'ContactPageController@index');
});
//won't be cached by Varnish
Route::get('do-not-cache', 'AnotherController@index');
The amount of minutes that Varnish should cache this content can be configured in the cache_time_in_minutes
key in the laravel-varnish.php
config file. Alternatively you could also use a middleware parameter to specify that value.
// Varnish will cache the responses of the routes inside the group for 15 minutes
Route::group(['middleware' => 'cacheable:15'], function() {
...
});
Behind the scenes the middleware will add an X-Cacheable
and Cache-Control
to the response. Varnish will remove all cookies from Laravel's response. So keep in mind that, because thelaravel_session
cookie will be removed as well, sessions will not work on routes were the CacheWithVarnish
middleware is applied.
There's an artisan command to flush the cache. This can come in handy in your deployment script.
php artisan varnish:flush
Under the hood flushing the cache will call the sudo varnishadm
. To make it work without any hassle make sure the command is run by a unix user that has sudo
rights.
You can also do this in your code to flush the cache:
(new Spatie\Varnish\Varnish())->flush();
Please see CHANGELOG for more information what has changed recently.
$ composer test
Please see CONTRIBUTING for details.
If you discover any security related issues, please email freek@spatie.be instead of using the issue tracker.
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.
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.
The MIT License (MIT). Please see License File for more information.