NAME

Nginx::Redis - asynchronous redis client for nginx-perl

SYNOPSIS

use Nginx::Redis;

ngx_redis '127.0.0.1:6379', ['GET', 'mykey'], sub {
    my ($reply) = @_;
    
    unless ($reply) {
        warn "error: no reply from redis\n";
        return;
    }
    
    # $reply = ['$', 'myvalue']
};

DESCRIPTION

Fast asynchronous redis client for nginx-perl that supports pipelining and doesn't provide any command-bound interface. You can use it for almost any feature of redis. Currently it doesn't support pub/sub-like flow though.

Nginx::Redis relies on Redis::Parser::XS to parse reply messages. So you have to install it as well.

EXPORT

ngx_redis
ngx_redis_client
ngx_redis_request

FUNCTIONS

ngx_redis "$ip:$port:$auth:$timeout", ['GET', 'mykey'], sub { };

Encodes and sends request to the redis server specified by $ip:$port. If password is specified in $auth then AUTH command will precede.

Calls back with reply in $_[0]. Format of the reply described in Redis::Parser::XS.

On error calls back without any arguments. Tries to reconnect on the next request.

Every connection is cached forever.

Example:

ngx_redis '127.0.0.1', ['PING'], sub {
    my ($reply) = @_;
            
    # $reply = ['+', 'PONG']
};

AUTHOR

Alexandr Gomoliako <zzz@zzz.org.ua>

LICENSE

Copyright 2011 Alexandr Gomoliako. All rights reserved.

This module is free software. It may be used, redistributed and/or modified under the same terms as Perl itself.