mbretter / stk-cache
Cache implementation PSR-6 and PSR-16
Installs: 2 970
Dependents: 0
Suggesters: 0
Security: 0
Stars: 1
Watchers: 2
Forks: 0
Open Issues: 0
Requires
- php: ^8.0
- mbretter/stk-di: >=2.0.1
- psr/cache: ^3.0.0
- psr/simple-cache: ^3.0.0
Requires (Dev)
- friendsofphp/php-cs-fixer: ^2.14
- php-mock/php-mock-phpunit: ^2.6.0
- phpstan/phpstan: ^1.2.0
- phpunit/phpunit: ^9
Suggests
- ext-apcu: *
- ext-memcached: *
README
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.