Laravel Page Cache
This package allows you to easily cache responses as static files on disk for lightning fast page loads.
Introduction
While static site builders such as Jekyll and Jigsaw are extremely popular these days, dynamic PHP sites still offer a lot of value even for a site that is mostly static. A proper PHP site allows you to easily add dynamic functionality wherever needed, and also means that there's no build step involved in pushing updates to the site.
That said, for truly static pages on a site there really is no reason to have to boot up a full PHP app just to serve a static page. Serving a simple HTML page from disk is infinitely faster and less taxing on the server.
The solution? Full page caching.
Using the middleware included in this package, you can selectively cache the response to disk for any given request. Subsequent calls to the same page will be served directly as a static HTML page!
Installation
Install the page-cache package with composer:
$ composer require silber/page-cache
Service Provider
Note: If you're using Laravel 5.5+, the service provider will be registered automatically. You can simply skip this step entirely.
Open config/app.php and add a new item to the providers array:
Silber\PageCache\LaravelServiceProvider::class,
Middleware
Open app/Http/Kernel.php and add a new item to the web middleware group:
protected $middlewareGroups = [
'web' => [
\Silber\PageCache\Middleware\CacheResponse::class,
/* ... keep the existing middleware here */
],
];
The middleware is smart enough to only cache responses with a 200 HTTP status code, and only for GET requests.
If you want to selectively cache only specific requests to your site, you should instead add a new mapping to the routeMiddleware array:
protected $routeMiddleware = [
'page-cache' => \Silber\PageCache\Middleware\CacheResponse::class,
/* ... keep the existing mappings here */
];
Once registered, you can then use this middleware on individual routes.
URL rewriting
In order to serve the static files directly once they've been cached, you need to properly configure your web server to check for those static files.
-
For nginx:
Update your
locationblock'stry_filesdirective to include a check in thepage-cachedirectory:location = / { try_files /page-cache/pc__index__pc.html /index.php?$query_string; } location / { try_files $uri $uri/ /page-cache/$uri.html /page-cache/$uri.json /index.php?$query_string; }
-
For apache:
Open
public/.htaccessand add the following before the block labeledHandle Front Controller:# Serve Cached Page If Available... RewriteCond %{REQUEST_URI} ^/?$ RewriteCond %{DOCUMENT_ROOT}/page-cache/pc__index__pc.html -f RewriteRule .? page-cache/pc__index__pc.html [L] RewriteCond %{DOCUMENT_ROOT}/page-cache%{REQUEST_URI}.html -f RewriteRule . page-cache%{REQUEST_URI}.html [L] RewriteCond %{DOCUMENT_ROOT}/page-cache%{REQUEST_URI}.json -f RewriteRule . page-cache%{REQUEST_URI}.json [L]
Ignoring the cached files
To make sure you don't commit your locally cached files to your git repository, add this line to your .gitignore file:
/public/page-cache
Usage
Using the middleware
Note: If you've added the middleware to the global
webgroup, then all successful GET requests will automatically be cached. No need to put the middleware again directly on the route.If you instead registered it as a route middleware, you should use the middleware on whichever routes you want to be cached.
To cache the response of a given request, use the page-cache middleware:
Route::middleware('page-cache')->get('posts/{slug}', 'PostController@show');
Every post will now be cached to a file under the public/page-cache directory, closely matching the URL structure of the request. All subsequent requests for this post will be served directly from disk, never even hitting your app!
Clearing the cache
Since the responses are cached to disk as static files, any updates to those pages in your app will not be reflected on your site. To update pages on your site, you should clear the cache with the following command:
php artisan page-cache:clear
As a rule of thumb, it's good practice to add this to your deployment script. That way, whenever you push an update to your site the page cache will automatically be cleared.
If you're using Forge's Quick Deploy feature, you should add this line to the end of your Deploy Script. This'll ensure that the cache is cleared whenever you push an update to your site.
You may optionally pass a URL slug to the command, to only delete the cache for a specific page:
php artisan page-cache:clear {slug}
To clear everything under a given path, use the --recursive flag:
php artisan page-cache:clear {slug} --recursive
For example, imagine you have a category resource under /categories, with the following cached pages:
/categories/1/categories/2/categories/5
To clear the cache for all categories, use --recursive with the categories path:
php artisan page-cache:clear categories --recursive
Customizing what to cache
By default, all GET requests with a 200 HTTP response code are cached. If you want to change that, create your own middleware that extends the package's base middleware, and override the shouldCache method with your own logic.
-
Run the
make:middlewareArtisan command to create your middleware file:php artisan make:middleware CacheResponse -
Replace the contents of the file at
app/Http/Middleware/CacheResponse.phpwith this:<?php namespace App\Http\Middleware; use Symfony\Component\HttpFoundation\Request; use Symfony\Component\HttpFoundation\Response; use Silber\PageCache\Middleware\CacheResponse as BaseCacheResponse; class CacheResponse extends BaseCacheResponse { protected function shouldCache(Request $request, Response $response) { // In this example, we don't ever want to cache pages if the // URL contains a query string. So we first check for it, // then defer back up to the parent's default checks. if ($request->getQueryString()) { return false; } return parent::shouldCache($request, $response); } }
-
Finally, update the middleware references in your
app/Http/Kernel.phpfile, to point to your own middleware.
License
The Page Cache package is open-sourced software licensed under the MIT license.
45 Nov 30, 2022
24 Nov 16, 2022
441 Jan 5, 2023
614 Dec 26, 2022
2 Feb 9, 2022
1 Aug 7, 2022
776 Dec 25, 2022
6 Dec 6, 2022
43 Nov 20, 2022
0 Jul 13, 2019
31 Dec 29, 2022
48 Dec 29, 2022
13 Aug 17, 2022
16 Jul 7, 2022
187 Dec 25, 2022
3 Jul 19, 2022
31 Dec 29, 2022
8 Dec 6, 2022