Redisent is a simple, no-nonsense interface to the Redis data structure store for modest developers. It is designed to flexible and tolerant of changes to the Redis protocol.

If you're at all familiar with the Redis protocol and PHP objects, you've already mastered Redisent. Redisent translates method calls to their Redis protocol equivalent, abstracting away the nitty-gritty, and then makes the return values PHP compatible.

The Redisent method names map directly to their Redis command counterparts. The full list is available in the command reference.

$redis->set('foo', 'bar')
// SET foo bar

$redis->lpush('particles', 'electron')
// LPUSH particles electron
$redis->lpush('particles', 'proton')
// LPUSH particles proton
$redis->lpush('particles', 'neutron')
// LPUSH particles neutron
$redis->llen('particles')
// LLEN particles

Redisent provides a fluent interface for pipelining commands to Redis.

$redis->pipeline()
  ->set('X', 2)
  ->incr('X')
  ->incr('X')
  ->uncork(); // #=> array containing the responses of each command

Redisent has no dependencies aside from requiring PHP versions 5.3 and later. To add it to your project, simply drop the Redis.php file into your project structure, instantiate a Redis instance, and start issuing commands.

require_once 'redisent/Redis.php';
$redis = new redisent\Redis('redis://localhost');
$redis->set('awesome', 'absolutely');
echo "Is Redisent awesome? ", $redis->get('awesome'), "\n";

Any errors originating from Redis will be wrapped in a resident\RedisException and thrown.

Redisent supports a fluent interface for pipelining. A pipeline is started by calling the pipeline method on a Redis instance, using Redisent as usual, and then calling the uncork method. The uncork method returns an array of the responses of the pipelined commands.

$redis = new Redisent\Redis();
$responses = $redis->pipeline()
    ->incr('X')
    ->incr('X')
    ->incr('X')
    ->incr('X')
    ->uncork();
print_r($responses);

If the key X didn't exist, the first INCR would create it and return 1, and successive calls would increment it by 1. The return value of the call to uncork() would be array(1,2,3,4), the responses of each INCR command.

Pull requests please! Feature/topic branches are especially appreciated. Unit tests are written with SimpleTest, please include tests in your pull request. To run tests, run sh setup.sh script to get set up and then php tests/all_tests.php to run the suite.

Redis has grown to be very feature rich, and Redisent is lagging behind.

• Publish/subscribe
• Transactions

Copyright © 2009-2012 Justin Poliey

Licensed under the ISC License.

Copyright (c) 2009-2012 Justin Poliey [email protected]

Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.

THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.