NAME

AnyEvent::Hiredis - AnyEvent hiredis API

SYNOPSIS

use AnyEvent::Hiredis;

my $redis = AnyEvent::Hiredis->new(
    host => '127.0.0.1',
    port => 6379,
);

$redis->command( [qw/SET foo bar/], sub { warn "SET!" } );
$redis->command( [qw/GET foo/], sub { my $value = shift } );

$redis->command( [qw/LPUSH listkey value/] );
$redis->command( [qw/LPOP listkey/], sub { my $value = shift } );

# errors
$redis->command( [qw/SOMETHING WRONG/, sub { my $error = $_[1] } );

DESCRIPTION

AnyEvent::Hiredis is an AnyEvent Redis API that uses the hiredis C client library (https://github.com/antirez/hiredis).

PERFORMANCE

One reason to consider AnyEvent::Hiredis over its pure Perl counterpart AnyEvent::Redis is performance. Here's a head to head comparison of the two modules running on general purpose hardware:

Rate     ae_redis  ae_hiredis
    AnyEvent::Redis    7590/s   --        -89%
    AnyEvent::Hiredis 69400/s   814%      --

Rate here is the number of set operations per second achieved by each module. See bin/compare.pl for details.

METHODS

new

my $redis = AnyEvent::Hiredis->new; # 127.0.0.1:6379

my $redis = AnyEvent::Hiredis->new(server => '192.168.0.1', port => '6379');

command

command takes an array ref representing a Redis command and a callback. When the command has completed the callback is executed and passed the result or error.

$redis->command( ['SET', $key, 'foo'], sub {
    my ($result, $error) = @_;

    $result; # 'OK'
});

$redis->command( ['GET', $key], sub {
    my ($result, $error) = @_;

    $result; # 'foo'
});

If the Redis server replies with an error then $result will be undef and $error will contain the Redis error string. Otherwise $error will be undef.

REPOSITORY

http://github.com/wjackson/anyevent-hiredis

AUTHORS

Whitney Jackson

Jonathan Rockway

SEE ALSO

Redis, Hiredis::Async, AnyEvent::Redis