Alexandr Gomoliako > Nginx-Redis-1.1.12.4 > Nginx::Redis

Download:
Nginx-Redis-1.1.12.4.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 1.1.12.4   Source  

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.

syntax highlighting: