Middleware with various cache utilities

v2.1.0 2020-12-02 00:05 UTC

This package is auto-updated.

Last update: 2023-03-01 00:11:14 UTC


Latest Version on Packagist Software License Testing Total Downloads

Middleware components with the following cache utilities:



This package is installable and autoloadable via Composer as middlewares/cache.

composer require middlewares/cache


To add the response headers for cache prevention. Useful in development environments:

    new Middlewares\CachePrevention()


This middleware adds the Expires and Cache-Control: max-age headers to the response. You can configure the cache duration for each mimetype. If it's not defined, use the defaults.

// Use the default configuration
$expires = new Middlewares\Expires();

// Custom durations
$expires = new Middlewares\Expires([
    'text/css' => '+1 year',
    'text/js' => '+1 week',


Set the default expires value if the request mimetype is not configured. By default is 1 month. Example:

//set 1 year lifetime to css and js
$durations = [
    'text/css' => '+1 year',
    'text/javascript' => '+1 year',

//and 1 hour to everything else
$default = '+1 hour';

$expires = (new Middlewares\Expires($durations))->defaultExpires($default);


Saves the response headers in a PSR-6 cache pool and returns 304 responses (Not modified) if the response is still valid. This saves server resources and bandwidth because the body is returned empty. It's recomended to combine it with Expires to set the lifetime of the responses.

$cachePool = new Psr6CachePool();

    new Middlewares\Cache($cachePool),
    new Middlewares\Expires()

Optionally, you can provide a Psr\Http\Message\ResponseFactoryInterface as the second argument to create the 304 empty responses. If it's not defined, Middleware\Utils\Factory will be used to detect it automatically.

$cachePool = new Psr6CachePool();
$responseFactory = new MyOwnResponseFactory();

$cache = new Middlewares\Cache($cachePool, $responseFactory);


Send the header Clear-Site-Data to remove all site data in the client (cache, cookies, storage etc)

    new Middlewares\ClearSiteData()

Optionally, you can provide the list of data types that you want to clear.

$cache = new Middlewares\ClearSiteData('cache', 'cookies');

Please see CHANGELOG for more information about recent changes and CONTRIBUTING for contributing details.

The MIT License (MIT). Please see LICENSE for more information.