/ 
Cache-RedisDB-0.13
River stage one • 6 direct dependents • 6 total dependents
/ Cache::RedisDB

NAME

Cache::RedisDB - RedisDB based cache system

DESCRIPTION

This is just a wrapper around RedisDB to have a single Redis object and connection per process. By default uses server redis://127.0.0.1, but it may be overwritten by REDIS_CACHE_SERVER environment variable. It transparently handles forks.

COMPATIBILITY AND REQUIREMENTS

Redis 2.6.12 and higher strongly recommended. Required if you want to use extended options in ->set().

SYNOPSIS

use Cache::RedisDB;
Cache::RedisDB->set("namespace", "key", "value");
Cache::RedisDB->get("namespace", "key");

METHODS

redis_uri

Returns a redis:// redis URI which will be used for the initial Redis connection.

This will default to localhost on the standard port, and can be overridden with the REDIS_CACHE_SERVER environment variable.

redis_connection

Creates new connection to a Redis server and returns the corresponding RedisDB object.

redis

Returns a singleton RedisDB instance.

get

Takes a $namespace and $key parameter, and returns the scalar value corresponding to that cache entry.

This will automatically deserialise data stored with Sereal. If no data is found, this will return undef.

mget

Retrieve values for multiple keys in a single call.

Similar to "get", this takes a $namespace as the first parameter, but it also accepts a list of @keys to look up.

Returns an arrayref in the same order as the original keys. For any key that had no value, the resulting arrayref will contain undef.

set

Creates or updates a Redis key under $namespace, $key using the scalar $value. Also takes an optional $exptime as expiration time in seconds.

$redis->set($namespace, $key, $value);
$redis->set($namespace, $key, $value, $expiry_time);

Can also be provided a callback which will be executed once the command completes.

set_nw($namespace, $key, $value[, $exptime])

Same as set but do not wait confirmation from server. If the server returns an error, it will be ignored.

del($namespace, $key1[, $key2, ...])

Delete given keys and associated values from the cache. $namespace is common for all keys. Returns number of deleted keys.

keys($namespace)

Return an arrayref of all known keys in the provided $namespace.

ttl($namespace, $key)

Return the Time To Live (in seconds) of a key in the provided $namespace.

flushall

Delete all keys and associated values from the cache.

AUTHOR

binary.com, <perl at binary.com>

BUGS

Please report any bugs or feature requests to bug-cache-redisdb at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Cache-RedisDB. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc Cache::RedisDB

You can also look for information at: