desarrolla2/cache

Provides an cache interface for several adapters Apc, Apcu, File, Mongo, Memcache, Memcached, Mysql, Mongo, Redis is supported.

Tuesday, June 26, 2018
by desarrolla2
Repository
9 Watchers
108 Stars
358,388 Installations

PHP
41 Dependents
3 Suggesters
38 Forks
25 Open issues
25 Versions
8 % Grown

The README.md

Desarolla2 Cache

A simple cache library, implementing the PSR-16 standard using immutable objects., _(*1)

life-is-hard-cache-is , _(*2)

Caching is typically used throughout an applicatiton. Immutability ensure that modifying the cache behaviour in one location doesn't result in unexpected behaviour due to changes in unrelated code., _(*3)

Desarolla2 Cache aims to be the most complete, correct and best performing PSR-16 implementation available., _(*4)

![Latest version][ico-pre-release] ![Quality Score][ico-code-quality] ![Today Downloads][ico-today-downloads] [][link-gitter], _(*5)

Installation

composer require desarrolla2/cache

Usage

``` php use Desarrolla2\Cache\Memory as Cache;, _(*6)

$cache = new Cache();, _(*7)

$value = $cache->get('key');, _(*8)

if (!isset($value)) { $value = do_something(); $cache->set('key', $value, 3600); }, _(*9)

echo $value; ```, _(*10)

Adapters

The following implementation allows you to combine cache adapters., _(*11)

Chain

Options

You can set options for cache using the withOption or withOptions method. Note that all cache objects are immutable, setting an option creates a new object., _(*12)

TTL

All cache implementations support the ttl option. This sets the default time (in seconds) that cache will survive. It defaults to one hour (3600 seconds)., _(*13)

Setting the TTL to 0 or a negative number, means the cache should live forever., _(*14)

Methods

PSR-16 methods

Each cache implementation has the following Psr\SimpleCache\CacheInterface methods:, _(*15)

`get(string $key [, mixed $default])`

Retrieve the value corresponding to a provided key, _(*16)

`has(string $key)`

Retrieve the if value corresponding to a provided key exist, _(*17)

`set(string $key, mixed $value [, int $ttl])`

Add a value to the cache under a unique key, _(*18)

`delete(string $key)`

Delete a value from the cache, _(*19)

`clear()`

Clear all cache, _(*20)

`getMultiple(array $keys)`

Obtains multiple cache items by their unique keys, _(*21)

`setMultiple(array $values [, int $ttl])`

Persists a set of key => value pairs in the cache, _(*22)

`deleteMultiple(array $keys)`

Deletes multiple cache items in a single operation, _(*23)

Additional methods

The Desarrolla2\Cache\CacheInterface also has the following methods:, _(*24)

`withOption(string $key, string $value)`

Set option for implementation. Creates a new instance., _(*25)

`withOptions(array $options)`

Set multiple options for implementation. Creates a new instance., _(*26)

`getOption(string $key)`

Get option for implementation., _(*27)

Packers

Cache objects typically hold a Desarrolla2\Cache\Packer\PackerInterface object. By default, packing is done using serialize and unserialize., _(*28)

Available packers are:, _(*29)

SerializePacker using serialize and unserialize
JsonPacker using json_encode and json_decode
NopPacker does no packing
MongoDBBinaryPacker using serialize and unserialize to store as BSON Binary

PSR-16 incompatible packers

The JsonPacker does not fully comply with PSR-16, as packing and unpacking an object will probably not result in an object of the same class., _(*30)

The NopPacker is intended when caching string data only (like HTML output) or if the caching backend supports structured data. Using it when storing objects will might give unexpected results., _(*31)

Contributors

Twitter: @desarrolla2\ Twitter: @ArnoldDaniels, _(*32)

The Versions

26/06 2018

dev-master

9999999-dev https://github.com/desarrolla2/Cache/

Provides an cache interface for several adapters Apc, Apcu, File, Mongo, Memcache, Memcached, Mysql, Mongo, Redis is supported.

library cache

Provides an cache interface for several adapters Apc, Apcu, File, Mongo, Memcache, Memcached, Mysql, Mongo, Redis is supported.

desarrolla2/cache

The README.md

Desarolla2 Cache

Installation

Usage

Adapters

Options

TTL

Methods

PSR-16 methods

get(string $key [, mixed $default])

has(string $key)

set(string $key, mixed $value [, int $ttl])

delete(string $key)

clear()

getMultiple(array $keys)

setMultiple(array $values [, int $ttl])

deleteMultiple(array $keys)

Additional methods

withOption(string $key, string $value)

withOptions(array $options)

getOption(string $key)

Packers

PSR-16 incompatible packers

Contributors

The Versions

dev-master

The Requires

The Development Requires

by Daniel González

by Arnold Daniels

3.x-dev

The Requires

The Development Requires

by Daniel González

by Arnold Daniels

v3.0.0-beta1

The Requires

The Development Requires

by Daniel González

by Arnold Daniels

dev-psr-16

The Requires

The Development Requires

by Daniel González

by Arnold Daniels

v2.x-dev

The Requires

The Development Requires

by Daniel González

1.8.3

The Requires

The Development Requires

by Daniel González

1.8.x-dev

The Requires

The Development Requires

by Daniel González

v1.8.2

The Requires

The Development Requires

by Daniel González

v2.1.1

The Requires

The Development Requires

by Daniel González

v2.1.0

The Requires

The Development Requires

by Daniel González

v2.0.0

The Requires

The Development Requires

by Daniel González

dev-coveralls

The Requires

The Development Requires

by Daniel González

`get(string $key [, mixed $default])`

`has(string $key)`

`set(string $key, mixed $value [, int $ttl])`

`delete(string $key)`

`clear()`

`getMultiple(array $keys)`

`setMultiple(array $values [, int $ttl])`

`deleteMultiple(array $keys)`

`withOption(string $key, string $value)`

`withOptions(array $options)`

`getOption(string $key)`