stroker/cache

Provides a full page cache solution for ZF2

Monday, November 20, 2017
by bramstroker
Repository
13 Watchers
60 Stars
19,565 Installations

PHP
1 Dependents
0 Suggesters
25 Forks
1 Open issues
25 Versions
2 % Grown

The README.md

StrokerCache

, _(*1)

This module provides a full page cache solution for Laminas., _(*2)

Installation

Installation of StrokerCache uses composer. For composer documentation, please refer to getcomposer.org., _(*3)

cd my/project/directory
create or modify the composer.json file within your ZF2 application file with following contents:, _(*4)

json { "require": { "stroker/cache": "*" } }, _(*5)
install composer via curl -s https://getcomposer.org/installer | php (on windows, download https://getcomposer.org/installer and execute it with PHP). Then run php composer.phar install
open my/project/directory/configs/application.config.php and add the following key to your modules:, _(*6)

php 'StrokerCache',, _(*7)

Setup cache rules

Copy the file strokercache.local.php.dist to your config/autoload directory and rename to strokercache.local.php. Edit this file to reflect your needs., _(*8)

The module provides several strategies to determine if a page should be cached., _(*9)

By routename
By controller classname
By regex on the URI
Disable caching for authenticated users

Examples

Caching the home route:, _(*10)

<?php
return [
    'strokercache' => [
        'strategies' => [
            'enabled' => [
                'StrokerCache\Strategy\RouteName' => [
                    'routes' => [
                        'home'
                    ],
                ],
            ],
        ],
    ],
];

Caching the foo/bar route, but only for a GET request and only when the param id equals 60, _(*11)

<?php
return [
    'strokercache' => [
        'strategies' => [
            'enabled' => [
                'StrokerCache\Strategy\RouteName' => [
                    'routes' => [
                        'foo/bar' => [
                            'http_methods' => ['GET'],
                            'params' => ['id' => 60]
                        ]
                    ],
                ],
            ],
        ],
    ],
];

Change storage adapter

Storage adapter can be changed by configuration. Configuration structure is the same a StorageFactory consumes. See the Laminas reference guide. By default filesystem storage is used., _(*12)

Example using APC:, _(*13)

<?php
return array(
    'strokercache' => [
        'storage_adapter' => [
            'name' => 'Laminas\Cache\Storage\Adapter\Apc',
        ],
    ],
];

TTL

You can set the TTL (Time to live) for the cache items by specifying the option on the storage adapter configuration. Not all Laminas storage adapters support TTL, which also is the reason why StrokerCache doesn't support per item TTL at the moment., _(*14)

<?php
return [
    'strokercache' => [
        'storage_adapter' => [
            'name' => 'filesystem',
            'options' => [
              'cache_dir' => __DIR__ . '/../../data/cache'
            ],
        ],
    ],
];

Clearing the cache

You can invalidate cache items using the provided console route. Alternatively you could pull strokercache_service from the servicelocator and call clearByTags directly from your application (i.e. from an event listener)., _(*15)

Run the following command from your project root: php public/index.php strokercache clear <tags>, _(*16)

Multiple tags can be seperated by a ,. Every page which is cached by StrokerCache is identified using the following tags: - route_<routename>: Contains the matched routename of the page - controller_<controllername>: Contains the controllername - param_<paramname>_<paramvalue>: One tag for every route param, _(*17)

To clear every page renderered by the someAction in MyNamespace\MyController do the following: php public/index.php strokercache clear controller_MyNamespace\MyController,param_action:some, _(*18)

To clear the route with alias player but only for the player with id 60. php public/index.php strokercache clear route_player,param_id_60, _(*19)

Custom id generators

You can create your own id generator by implementing the StrokerCache\IdGenerator\IdGeneratorInterface. Now register your generator to the PluginManager:, _(*20)

<?php
return [
    'strokercache' => [
        'id_generators' => [
            'plugin_manager' => [
                'invokables' => [
                    'myGenerator' => 'MyNamespace\MyGenerator'
                ],
            ],
        ],
        'id_generator' => 'myGenerator'
    ],
];

Custom strategies

You can create your own strategies by implementing the StrokerCache\Strategy\StrategyInterface. Now register your strategy to the pluginManager:, _(*21)

<?php
return [
    'strokercache' => [
        'strategies' => [
            'plugin_manager' => [
                'invokables' => [
                    'MyNamespace\MyCustomStrategy'
                ],
            ],
        ],
    ],
];

Next you need to enable the strategy, _(*22)

<?php
return [
    'strokercache' => [
        'strategies' => [
            'enabled' => [
                'MyNamespace\MyCustomStrategy'
            ],
        ],
    ],
];

Disable FPC

You can disable the Caching solution all together by using the following configuration. This comes in handy on your development environment where you obviously don't want any caching to happen., _(*23)

<?php
return [
    'strokercache' => [
        'enabled' => false        
    ]
];

Events

The cache service triggers several events you can utilize to add some custom logic whenever saving/loading the cache happens. The events are listed as constants in the CacheEvent class:, _(*24)

EVENT_LOAD: triggered when the requested page is found in the cache and ready to be served to the client
EVENT_SAVE: triggered when your page is stored in the cache storage
EVENT_SHOULDCACHE: this event is used to determine if a page should be stored into the cache. You can listen to this event if you don't want the page to be cached. All the strategies are attached to this event as well.

Examples

Setting custom tags example, _(*25)

public function onBootstrap(MvcEvent $e)
{
    $serviceManager = $e->getApplication()->getServiceManager();
    $cacheService = $serviceManager->get('strokercache_service');
    $cacheService->getEventManager()->attach(CacheEvent::EVENT_SAVE, function (CacheEvent $e) {
        $e->setTags(['custom_tag']);
    });
}

Log to file whenever a page is written to the cache storage, _(*26)

public function onBootstrap(MvcEvent $e)
{
    $serviceManager = $e->getApplication()->getServiceManager();
    $logger = new \Laminas\Log\Logger();
    $logger->addWriter(new \Laminas\Log\Writer\Stream('/log/strokercache.log'));
    $cacheService = $serviceManager->get('strokercache_service');
    $cacheService->getEventManager()->attach(CacheEvent::EVENT_SAVE, function (CacheEvent $e) use ($logger) {
        $logger->debug('Saving page to cache with ID: ' . $e->getCacheKey());
    });
}

Say we want to disable caching for all requests on port 8080, we can simply listen to the SHOULDCACHE event and return false. Keep in mind you want to prevent other listeners from executing using stopPropagation(). If you don't do this other listeners will be executed and whenever one of them returns true the page will be cached. Also you need to attach the listener at a higher priority (1000 in this example) than the buildin strategies (they are registered at priority 100)., _(*27)

public function onBootstrap(MvcEvent $e)
{
    $serviceManager = $e->getApplication()->getServiceManager();
    $cacheService = $serviceManager->get('strokercache_service');
    $cacheService->getEventManager()->attach(CacheEvent::EVENT_SHOULDCACHE, function (CacheEvent $e) {
        if ($e->getMvcEvent()->getRequest()->getUri()->getPort() == 8080) {
            $e->stopPropagation(true);
            return false;
        }
        return true;
    }, 1000);
}

If you want to avoide caching because, for instance, the user is authenticated, do the same as above, but listen on LOAD instead of SHOULDCACHE:, _(*28)

public function onBootstrap(MvcEvent $e)
{
    $serviceManager = $e->getApplication()->getServiceManager();
    $cacheService = $serviceManager->get('strokercache_service');
    $cacheService->getEventManager()->attach(CacheEvent::EVENT_LOAD, function (CacheEvent $e) {
        $loggedIn = /* your logic here */;
        if ($loggedIn) {
            $e->stopPropagation(true);
            return false;
        }
    }, 1000);
}

Attention: Be aware, that you should probably disable storing for authenticated users as well:, _(*29)

public function onBootstrap(MvcEvent $e)
{
    $serviceManager = $e->getApplication()->getServiceManager();
    $cacheService = $serviceManager->get('strokercache_service');
    $cacheService->getEventManager()->attach(CacheEvent::EVENT_SHOULDCACHE, function (CacheEvent $e) {
        $loggedIn = /* your logic here */;
        if ($loggedIn) {
            $e->stopPropagation(true);
            return false;
        }
    }, 1000);
}

Store directly to HTML files for max performance

This is still a bit expirimental. Please see this issue for some pointers how to get this working., _(*30)

The Versions

20/11 2017

dev-master

9999999-dev https://github.com/bramstroker/zf2-fullpage-cache

Provides a full page cache solution for ZF2

library cache

Provides a full page cache solution for ZF2

stroker/cache

The README.md

StrokerCache

Installation

Setup cache rules

Examples

Change storage adapter

TTL

Clearing the cache

Custom id generators

Custom strategies

Disable FPC

Events

Examples

Store directly to HTML files for max performance

The Versions

dev-master

The Requires

The Development Requires

by Bram Gerritsen

by Freek Gruntjes

2.1.0

The Requires

The Development Requires

by Bram Gerritsen

by Freek Gruntjes

dev-travis

The Requires

The Development Requires

by Bram Gerritsen

by Freek Gruntjes

2.0.1

The Requires

The Development Requires

by Bram Gerritsen

by Freek Gruntjes

dev-issue-51

The Requires

The Development Requires

by Bram Gerritsen

by Freek Gruntjes

2.0

The Requires

The Development Requires

by Bram Gerritsen

by Freek Gruntjes

dev-issue-44

The Requires

The Development Requires

by Bram Gerritsen

by Freek Gruntjes

dev-issue-34

The Requires

The Development Requires

by Bram Gerritsen

by Freek Gruntjes

v2.x-dev

The Requires

The Development Requires

by Bram Gerritsen

by Freek Gruntjes

1.0.0-RC1

The Requires

The Development Requires

by Bram Gerritsen

by Freek Gruntjes

dev-zf3

The Requires

The Development Requires

by Bram Gerritsen

by Freek Gruntjes

0.3.2

The Requires

The Development Requires

by Bram Gerritsen

by Freek Gruntjes

0.3.1

The Requires