README

behance/nbd.php-cache

Provides basis for communicating with memcache servers, abstracts away interface differences between Memcache, Memcached, and Redis PECL extensions

Goals

1. Have minimal dependencies, to be used in very diverse environments.
2. Migration tool: flexibly switch between Memcache, Memcached, and Redis PECL extensions using a single interface

• Automatically detect PECL extensions and leverage them in priority order (Memcached over Memcache over Redis)

1. Make every attempt to shield connection and management logic from implementer
2. Support limited cache "transaction" functionality: Just like an ACID DB transaction, reads + writes only visible single process until committed. Helpful for embedded cache processes that follow actual DB transactions.
3. Provide deep introspection with events

Implementation Note

• Redis, at time of writing, connects at the moment of configuration. Until lazy instantiation is fully implemented in the released PECL extension (milestone 3.1.0), initial connection errors are sadly swallowed to work similar to memcache/memcached.

Usage

use Behance\NBD\Cache;

$config = [
  [
    'host' => 'cache1.com',
    'port' => 11211
  ],
  [
    'host' => 'cache2.com',
    'port' => 11212
  ],
  //[
  //  ... add as many servers as necessary
  //]
];

Create an adapter based on the presence of memcache/memcached/redis extensions

$cache = Cache\Factory::create($config);

Or, build a instance of a specific type:

$cache = Cache\Factory::create($config, Factory::TYPE_REDIS);
$cache = Cache\Factory::create($config, Factory::TYPE_MEMCACHE);
$cache = Cache\Factory::create($config, Factory::TYPE_MEMCACHED);

Retrieve a single value

$cache->get('abcdefg');

Retrieve multiple values

$cache->getMulti(['abcdefg', 'hijklmn']); // Result preserves order

Testing

Unit testing, requires memcache, memcached, and redis plugins:

1. composer install
2. ./vendor/bin/phpunit

(preferred) Integration testing: leverages docker / docker-compose, using actual service containers for memcache and redis)

1. (on PHP 7.1) docker-compose build seven && docker-compose run sevenone
2. (on PHP 7.2) docker-compose build seven && docker-compose run seventwo

Operations