anahkiasen / flatten
A package for the Illuminate framework that flattens pages to plain HTML
Installs: 13 022
Dependents: 1
Suggesters: 2
Security: 0
Stars: 336
Watchers: 14
Forks: 42
Open Issues: 7
Requires
- illuminate/cache: 5.0.*|5.1.*
- illuminate/config: 5.0.*|5.1.*
- illuminate/container: 5.0.*|5.1.*
- illuminate/contracts: 5.0.*|5.1.*
- illuminate/http: 5.0.*|5.1.*
- illuminate/support: 5.0.*|5.1.*
- mrclay/minify: ^2.2
Requires (Dev)
- fabpot/php-cs-fixer: ^1.10
- illuminate/view: 5.0.*|5.1.*
- mockery/mockery: ^0.9.4
- phpunit/phpunit: ^4.8
- symfony/var-dumper: ^2.7
README
Flatten is a powerful cache system for caching pages at runtime. What it does is quite simple : you tell him which page are to be cached, when the cache is to be flushed, and from there Flatten handles it all. It will quietly flatten your pages to plain HTML and store them. That whay if an user visit a page that has already been flattened, all the PHP is highjacked to instead display a simple HTML page. This will provide an essential boost to your application's speed, as your page's cache only gets refreshed when a change is made to the data it displays.
Setup
Installation
Flatten installs just like any other package, via Composer : composer require anahkiasen/flatten
.
Then if you're using Laravel, add Flatten's Service Provider to you config/app.php
file :
Flatten\FlattenServiceProvider::class,
And its facade :
'Flatten' => Flatten\Facades\Flatten::class,
Configuration
All the options are explained in the config.php configuration file. You can publish it via artisan vendor:publish
.
Usage
The pages are cached according to two parameters : their path and their method. Only GET requests get cached as all the other methods are dynamic by nature.
All of the calls you'll make, will be to the Flatten\Facades\Flatten
facade.
Query strings are taken into account in the cache and pages will different query strings will have different caches.
Building
Flatten can cache all authorized pages in your application via the artisan flatten:build
command. It will crawl your application and go from page to page, caching all the pages you allowed him to.
Flushing
Sometimes you may want to flush a specific page or pattern. If per example you cache your users's profiles, you may want to flush those when the user edit its informations. You can do so via the following methods :
// Manual flushing Flatten::flushAll(); Flatten::flushPattern('users/.+'); Flatten::flushUrl('http://localhost/users/taylorotwell'); // Flushing via an UrlGenerator Flatten::flushRoute('user', 'taylorotwell'); Flatten::flushAction('UsersController@user', 'taylorotwell'); // Flushing template sections (see below) Flatten::flushSection('articles');
You can also directly inject the responsible class, in a model observer class per example:
use Flatten\CacheHandler; class UserObserver { protected $cache; public function __construct(CacheHandler $cache) { $this->cache = $cache; } public function saved(User $user) { $this->cache->flushRoute('users.show', $user->id); } }
Runtime caching
You don't have to cache all of a page, you can fine-tune your cache in smaller cached sections.
In PHP you'd do it like this :
<h1>This will always be dynamic</h1> <?php foreach ($articles as $article): ?> <?= $article->name ?> <?php endforeach; ?> <h1>This will not</h1> <?php Flatten::section('articles', function () use ($articles) { ?> <?php foreach ($articles as $article): ?> <?= $article->name ?> <?php endforeach; ?> <?php }); ?>
You can also specify for how long you want that section to be cached by adding an argument to section
:
<!-- This section will be cached for 10 minutes --> <?php Flatten::section('articles', 10, function () use ($articles) { ?> <?php foreach ($articles as $article): ?> <?= $article->name ?> <?php endforeach; ?> <?php }); ?>
Flatten also hooks into the Blade templating engine for a leaner syntax. Let's rewrite our above example :
<h1>This will always be dynamic</h1> @foreach($articles as $articles) {{ $article->name }} @endforeach <h1>This will not</h1> @cache('articles', 10) @foreach($articles as $article) {{ $article->name }} @endforeach @endcache
Kickstarting
You can speed up Flatten even more by using the Flatten::kickstart
method. It requires a little more boilerplate code but can enhance performances dramatically.
Basically you want to call that before everything else (ie. before even loading Composer). On Laravel you'd put that code at the top of bootstrap/autoload.php
.
You use it like that :
require __DIR__.'/../vendor/anahkiasen/flatten/src/Flatten/Flatten.php'; Flatten\Flatten::kickstart();
If you have things in your saltshaker, you'll need to find faster raw methods to get these and pass the salts as arguments :
require __DIR__.'/../vendor/anahkiasen/flatten/src/Flatten/Flatten.php'; $salt = mysql_query('SOMETHING'); Flatten\Flatten::kickstart($salt);
Using outside of Laravel
Flatten can easily be used outside of Laravel, for this you'll basically only ever use two methods. What you basically want to do is call Flatten::start
at the top of the page, and Flatten::end
at the bottom.
<?php require 'vendor/autoload.php'; use Flatten\Facades\Flatten; ?> <?php Flatten::start() ?> <!DOCTYPE html> <head></head> <body></body> </html> <?php Flatten::end() ?>