nepada/bust-cache

Cache busting macro for Latte.

v1.1.1 2018-03-03 20:18 UTC

README

Build Status Coverage Status Downloads this Month Latest stable

Installation

Via Composer:

$ composer require nepada/bust-cache

Register the extension in config.neon:

extensions:
    - Nepada\Bridges\BustCacheDI\BustCacheExtension(%wwwDir%, %debugMode%)

If you're using stand-alone Latte, install the macro manually:

$latte->addMacro('bustCache', new Nepada\BustCache\BustCacheMacro($wwwDir, $debugMode));

Usage

Example:

<link rel="stylesheet" href="{bustCache /css/style.css}">

In debug mode the macro busts cache by appending timestamp of last file modification:

<link rel="stylesheet" href="/css/style.css?1449177985">

In production mode the macro busts cache by appending first 10 letters of md5 hash of the file content:

<link rel="stylesheet" href="/css/style.css?a1d0c6e83f">

Note: It is not recommended (but supported) to pass variables into the macro, because they need to be resolved in run-time and thus the file is read on every request.