Cachalot
Cachalot (cache a lot) is an easy to use caching library. It supposed to do the only one thing - return cached callback result., (*1)
Installation
Define the following requirement in your composer.json file:, (*2)
"require": {
"ihor/cachalot": "2.3"
}
Usage
// With Cachalot cache you can easily cache results of different types of functions
$cache = new \Cachalot\ArrayCache();
// built-in functions
$length = $cache->getCached('strlen', ['hello world']);
// user defined functions
$unique = $cache->getCached('uniqueValues', [[1, 2, 3, 1, 2, 3]]);
// static methods
$result = $cache->getCached(['Calculator', 'subtract'], [1, 2]);
// instance methods
$square = $cache->getCached([new Calculator(), 'square'], [5]);
// anonymous functions
$reason = $cache->getCached($getErrorReason, [], \Cachalot\Cache::ONE_DAY, 'error-reason');
// callable objects
$trimed = $cache->getCached(new Trimmer(), [' hello world ']);
Reference
Cache API
getCached($callback, array $args = array(), $expireIn = 0, $suffix = null, $useSuffixAsKey = false)
Returns cached $callback result, (*3)
$callback is the function (callable) which results we want to be cached
$args are the arguments passed to the $callback
$expireIn sets cache TTL in seconds
$suffix is needed to avoid collisions when callback is an anonymous function
$useSuffixAsKey when true cache suffix will be used as a cache key, (*4)
$length = $cache->getCached('strlen', ['hello world']);
To have possibility to use Cachalot as a regular caching library when needed it contains classic cache methods, (*5)
contains($key)
Returns true if cache contains entry with given key, (*6)
if ($cache->contains('lastVisit')) {
echo 'This is not the first visit';
}
get($key)
Returns cached value by key or false if there is no cache entry for the given key, (*7)
if ($lastVisitDate = $cache->get('lastVisit')) {
echo sprintf('Last visit was at %s', $lastVisitDate);
}
set($key, $value, $expireIn = 0)
Caches value by key. When $expireIn = 0 the value is cached forever, (*8)
$cache->set('lastVisit', time());
delete($key)
Deletes cache entry by key, (*9)
$cache->delete('lastVisit');
clear()
Deletes all cache entries, (*10)
$cache->clear();
Back-ends
Cachalot\ApcCache
Stores data in APC, (*11)
$cache = new Cachalot\ApcCache();
Cachalot\XcacheCache
Stores data in Xcache, (*12)
$cache = new Cachalot\XcacheCache();
Cachalot\MemcacheCache
Stores data in Memcached using Memcache PHP extension, (*13)
$memcache = new \Memcache();
$memcache->connect('unix:///usr/local/var/run/memcached.sock', 0);
$cache = new \Cachalot\MemcacheCache($memcache);
Cachalot\MemcachedCache
Stores data in Memcached using Memcached PHP extension, (*14)
$memcached = new \Memcached();
$memcached->addServer('/usr/local/var/run/memcached.sock', 0);
$cache = new \Cachalot\MemcachedCache($memcached);
Cachalot\RedisCache
Stores data in Redis, (*15)
$redis = new \Redis();
$redis->connect('127.0.0.1');
$redis->select(1);
$cache = new \Cachalot\RedisCache($redis);
Cachalot\CouchbaseCache
Stores data in Couchbase using Couchbase PHP SDK 1.x, (*16)
$couchbase = new \Couchbase('127.0.0.1', '', '', 'default');
$cache = new \Cachalot\CouchbaseCache($couchbase);
Cachalot\Couchbase2Cache
Stores data in Couchbase using Couchbase PHP SDK 2.x, (*17)
$cluster = new \CouchbaseCluster('couchbase://localhost');
$bucket = $cluster->openBucket('default');
$cache = new \Cachalot\Couchbase2Cache($bucket);
Cachalot\ArrayCache
Stores data in PHP array, (*18)
$cache = new \Cachalot\ArrayCache();
Cachalot\BlackholeCache
Never stores any data, (*19)
$cache = new \Cachalot\BlackholeCache();
Wallogit.com
