mbretter/stk-cache

Cache implementation PSR-6 and PSR-16

3.1.0 2022-08-09 09:04 UTC

This package is auto-updated.

Last update: 2024-10-09 13:28:48 UTC


README

License PHP 8.0 Latest Stable Version Total Downloads CI

Support for memcached and APCu is included.

Memcached

$memcached = new Memcached();
$memcached->addServer("127.0.0.1", 11211, 50]);
$pool = new Cache\Pool\Memcached($memcached);

$cache = new Cache\Cache($pool);

APCu

$pool = new Cache\Pool\APCu();
$cache = new Cache\Cache($pool);

Blackhole

The blackhole pool is a dummy pool, which does not do any caching. It can be used on a development environment, when caching should be disabled.

$pool = new Cache\Pool\Blackhole();
$cache = new Cache\Cache($pool);

Memory

A cache pool which uses an instance variable of the pool object as cache.

$pool = new Cache\Pool\Memory();
$cache = new Cache\Cache($pool);

Additional methods

Besides, the PSR standards, the Cache has implemented some useful extra methods.

getSet

getSet invokes a closure, if the key was not found inside the cache. This helps to build a linear code base, without additional conditions checking whether the key was found or not.

If the key was found, the value is returned directly, without invkoing the closure.

$pool = new Cache\Pool\APCu();
$cache = new Cache\Cache($pool);

$val = $cache->getSet('mykey', function() {
    // ... do some expensive calculations
    return $val;
});

Grouping

If you want to invalidate a group of cache items, by only removing one key, this could be done by using the group feature.

$groupkey = 'mygroup';

$cache->setGrouped($groupkey, 'key1', $val1);
$cache->setGrouped($groupkey, 'key2', $val2);
$cache->setGrouped($groupkey, 'key-' . uniqid(), $val2);

$cache->delete($groupkey); // invalidates key1, key2, key-xxxx

$val = $cache->getGrouped($groupkey, 'key1'); // $val is null

getSetGrouped works in the same way as getSet, but with the additional group key.