gilbitron/hoard

PHP caching done right

Hoard

, _(*1)

Hoard is a simple, extensible PHP caching library., _(*2)

Install

Install via composer:, _(*3)

{
    "require": {
        "gilbitron/hoard": "~0.1.0"
    }
}

Run composer install then use as normal:, _(*4)

require 'vendor/autoload.php';
$cache = new Hoard\Hoard();

API

Hoard uses the conecpt of "drawers" (as in a chest of drawers) as drivers for caching., _(*5)

$cache = new Hoard\Hoard($drawer = 'file', $options = [], $args = []);

Possible drawers (more to come):, _(*6)

• file

$options is an array of options passed to the chosen drawer. See Drawers section below., _(*7)

$args: * encrypt_keys - Use encrypted keys (default: true) * encryption_function - Function to use for encrypting keys md5/sha1 (default: md5), _(*8)

Determine if an item exists in the cache, _(*9)

$cache->has($key);

Retrieve an item from the cache by key, _(*10)

$cache->get($key, $default = null);

Retrieve an item from the cache and delete it, _(*11)

$cache->pull($key, $default = null);

Store an item in the cache. $minutes can be an int or DateTime, _(*12)

$cache->put($key, $value, $minutes);

Store an item in the cache if the key does not exist. $minutes can be an int or DateTime, _(*13)

$cache->add($key, $value, $minutes);

Store an item in the cache indefinitely, _(*14)

$cache->forever($key, $value);

Remove an item from the cache, _(*15)

$cache->forget($key);

Remove all items from the cache, _(*16)

$cache->flush();

Drawers

file

Basic FileSystem caching., _(*17)

Options:, _(*18)

• cache_dir - Path to cache directory. Uses the system tmp dir if none provided.

Credits

Hoard was created by Gilbert Pellegrom from Dev7studios. Released under the MIT license., _(*19)