Skip to main content

Cache Engine

Build Status Opensource ByJG GitHub source GitHub license GitHub release

A multi-purpose cache engine PSR-6 and PSR-16 implementation with several drivers.

PSR-16

PSR-16 defines a Simple Cache interface with less verbosity than PSR-6. Below a list of engines available in this library that is PSR-16 compliant:

ClassDescription
\ByJG\Cache\Psr16\NoCacheEngineDo nothing. Use it for disable the cache without change your code
\ByJG\Cache\Psr16\ArrayCacheEngineLocal cache only using array. It does not persists between requests
\ByJG\Cache\Psr16\FileSystemCacheEngineSave the cache result in the local file system
\ByJG\Cache\Psr16\MemcachedEngineUses the Memcached as the cache engine
\ByJG\Cache\Psr16\RedisCachedEngineuses the Redis as cache
\ByJG\Cache\Psr16\SessionCachedEngineuses the PHP session as cache
\ByJG\Cache\Psr16\ShmopCachedEngineuses the shared memory area for cache

To create a new Cache Instance just create the proper cache engine and use it:

<?php
$cache = new \ByJG\Cache\Psr16\FileSystemCacheEngine();

// And use it:
if ($cache->has('key')) {
// Do the complex code to get the value to be cached
$object = callComplexCode();

// Save to cache
$cache->set('key', $object);
};
$object = $cache->get('key');

See more PSR-16 examples here

PSR-6

The PSR-6 implementation use the engines defined above. PSR-6 is more verbosity and have an extra layer do get and set the cache values.

You can use one of the factory methods to create a instance of the CachePool implementation:

<?php
$cachePool = \ByJG\Cache\Factory::createFilePool();

OR just create a new CachePool and pass to the constructor an instance of a PSR-16 compliant class:

$cachePool = new CachePool(new FileSystemCacheEngine());

See more PSR-6 examples here

List of Available Factory Commands

Note: All parameters are optional

EngineFactory Command
No CacheFactory::createNullPool($prefix, $bufferSize, $logger);
ArrayFactory::createArrayPool($bufferSize, $logger);
File SystemFactory::createFilePool($prefix, $bufferSize, $logger);
MemcachedFactory::createMemcachedPool($servers[], $bufferSize, $logger);
SessionFactory::createSessionPool($prefix, $bufferSize, $logger);
RedisFactory::createRedisCacheEngine($server, $pwd, $bufferSize, $logger);
ShmopFactory::createShmopPool($config[], $bufferSize, $logger);

The Common parameters are:

  • logger: A valid instance that implement the LoggerInterface defined by the PSR/LOG
  • bufferSize: the Buffer of CachePool
  • prefix: A prefix name to compose the KEY physically
  • servers: An array of memcached servers. E.g.: [ '127.0.0.1:11211' ]
  • config: Specific setup for shmop. E.g.: [ 'max-size' => 524288, 'default-permission' => '0700' ]

Logging cache commands

You can add a PSR Log compatible to the constructor in order to get Log of the operations

See log examples here

Use a PSR-11 container to retrieve the cache keys

You can use a PSR-11 compatible to retrieve the cache keys. Once is defined, only the keys defined in the PSR-11 will be used to cache.

<?php
$fileCache = new \ByJG\Cache\Psr16\FileSystemCacheEngine()
$fileCache->withKeysFromContainer(new SomePsr11Implementation());

After the PSR-11 container is defined, when I run:

$value = $fileCache->get('my-key');

The key my-key will be retrieved from the PSR-11 container and the value retrieved will be used as the cache key. If it does not exist in the PSR-11 container, an exception will be thrown.

Install

Just type:

composer require "byjg/cache-engine"

Running Unit Testes

vendor/bin/phpunit --stderr

Note: the parameter --stderr after phpunit is to permit run the tests on SessionCacheEngine.

Dependencies


Open source ByJG