jmatosp/tumbleweed-cache

PHP caching implementation of PSR-6

TumbleweedCache

, _(*1)

PHP Caching - PSR-6 implementation, _(*2)

This library provides Calling Libraries abstract cache services., _(*3)

Implementations for well known cache infrastructure, clever cache using multi-level/failover cache and clustered like cache., _(*4)

Drivers available: APCu, Redis, Files, Memcached, Memory, 2 Level Cache, _(*5)

All drivers where tested using PHPUnit and a great 3rd party testing suite for PSR-6, _(*6)

Install

composer require jmatosp/tumbleweed-cache

Usage

Simple to use, Tumbleweed Cache will try to use one of the available drivers APCu, Redis or Files, _(*7)

$cache = CacheFactory::make();
$item = $cache->getItem('my_key')
            ->set('value')
            ->expiresAfter(60);
$cache->save($item);
echo $cache->getItem('my_key')->get();
// will output "value"

or not using CacheFactory and instantiating APCu directly, _(*8)

$cache = new APCuCache();
$cache->getItem('hello')->set('value');
echo $cache->getItem('hello')->get();   // output: "value"

You can specify the cache implementation to use:, _(*9)

APCu, _(*10)

This driver supports both apc and apcu, works with HHVM (legacy), apcu only PHP7 and apc/apcu on PHP5.6, _(*11)

$cache = CacheFactory::make(CacheFactory::APCU);
$item = $cache->getItem('my_key')->set('value');
$cache->save($item);
echo $cache->getItem('my_key')->get();
// will output "value"

Redis, _(*12)

You can use the factory to create a Redis cache instance, factory will try to connect to default port on localhost, or you can provide a connection as in this example., _(*13)

$redis = new Redis();
$redis->connect('127.0.0.1');
$cache = CacheFactory::make(CacheFactory::REDIS, $redis);
$item = $cache->getItem('my_key')->set('value');
$cache->save($item);
echo $cache->getItem('my_key)->get();
// will output "value"

Files, _(*14)

File base cache interface, fast and uses /tmp directory. Cache factory will check if TMP dir is writable and throw and exception if not., _(*15)

$cache = CacheFactory::make(CacheFactory::FILE);
$item = $cache->getItem('my_key')->set('value');
$cache->save($item);
echo $cache->getItem('my_key)->get();
// will output "value"

Memcache, _(*16)

$memcached = new Memcached('my_app_ip');
$memcached->addServer('localhost', 11211);
$cache = CacheFactory::make(CacheFactory::MEMCACHED, $memcached);
$item = $cache->getItem('my_key')->set('value');
$cache->save($item);
echo $cache->getItem('my_key)->get();
// will output "value"

Two level, _(*17)

Two level cache aims to use 2 cache repositories, as failover with two remote caches or a combination of one local to with faster access like APCu and one remote typically Redis or Memcached. Also good to work as a failover cache in case of the first one fails. Sample using APCu as first level (faster) and Redis second level (fast), _(*18)

$localCache = CacheFactory::make(CacheFactory::APCU);
$remoteCache = CacheFactory::make(CacheFactory::REDIS);
$megaCache = CacheFactory::make(CacheFactory::TWO_LEVEL, $localCache, $remoteCache);
$item = $cache->getItem('my_key')->set('value');
$cache->save($item);
echo $cache->getItem('my_key')->get();
// will output "value"

Cache Factory

Cache factory enables creation to different type of cache infrastructure with an easy interface., _(*19)

It has a builtin auto-discovery that will try to find the fastest one available, to use the auto-discovery simply call the factory without parameters:, _(*20)

$cacheService = CacheFactory::make();

Auto-discovery will try to use cache infrastructure by this order: APCu, APC, File, Redis, _(*21)

PSR-6 Cache Interface

All cache item pool implementations use PSR-6 interfaces, for details please visit PHP-FIG PSR-6: Caching Interface, _(*22)

Running tests

To run all test including integration you need:, _(*23)

• Redis - installed locally on standard port 127.0.0.1:6379
• APCu - edit your php.ini and add "apc.enable_cli=1" after the extension loading to enable tests on APCu
• Memcached

Optionally you can run on the provided Vagrant box:, _(*24)

vagrant up
vagrant ssh
cd /vagrant
composer install
vendor/bin/phpunit