GitHub - EasyEngine/ngx_http_redis: You can use this module to perform simple caching. There are plans to extend this module in the near future. Latest version available at http://people.FreeBSD.org/~osa/ngx_http

This repository has been archived by the owner on Sep 4, 2020. It is now read-only.

EasyEngine / ngx_http_redis Public archive

Notifications You must be signed in to change notification settings
Fork 6
Star 4

You can use this module to perform simple caching. There are plans to extend this module in the near future. Latest version available at http://people.FreeBSD.org/~osa/ngx_http_redis-0.3.8.tar.gz.

View license

4 stars 6 forks Branches Tags Activity

Star

Notifications

Branches Tags

Name		Name	Last commit message	Last commit date
Latest commit History 1 Commit
t		t
AUTHOR		AUTHOR
CHANGES		CHANGES
LICENSE		LICENSE
README		README
config		config
ngx_http_redis_module.c		ngx_http_redis_module.c

Repository files navigation

nginx HTTP redis module
--

Description:
--

The nginx HTTP redis module for caching with redis,
http://code.google.com/p/redis/.

The redis protocol
(http://code.google.com/p/redis/wiki/ProtocolSpecification)
not yet fully implemented, but GET and SELECT commands only.



Installation:
--

You'll need to re-compile Nginx from source to include this module.
Modify your compile of Nginx by adding the following directive
(modified to suit your path of course):

./configure --add-module=/absolute/path/to/ngx_http_redis
make
make install



Usage:
--

Example 1.


http
{
 ...
        server {
                location / {
                        set $redis_key  "$uri?$args";
                        redis_pass      127.0.0.1:6379;
                        error_page      404 502 504 = @fallback;
                }

                location @fallback {
                        proxy_pass      backed;
                }
        }
}


Example 2.

Capture User-Agent from an HTTP header, query to redis database
for lookup appropriate backend.

Eval module (http://www.grid.net.ru/nginx/eval.en.html) required.

http
{
 ...
    upstream redis {
        server  127.0.0.1:6379;
    }

    server {
     ...
        location / {

	    eval_escalate on;

	    eval $answer {
		set $redis_key	"$http_user_agent";
		redis_pass	redis;
	    }

            proxy_pass $answer;
        }
        ...
     }
}


Example 3.

Compile nginx with ngx_http_redis and ngx_http_gunzip_filter modules
(http://mdounin.ru/hg/ngx_http_gunzip_filter_module/).
Gzip content and put it into redis database.

% cat index.html
<html><body>Hello from redis!</body></html>
% gzip index.html
% cat index.html.gz | redis-cli -x set /index.html
OK
% cat index.html.gz | redis-cli -x set /
OK
%

Using following configuration nginx get data from redis database and
gunzip it.

http
{
 ...
    upstream redis {
        server  127.0.0.1:6379;
    }

    server {
     ...
        location / {
                gunzip on;
                redis_gzip_flag 1;
                set $redis_key "$uri";
                redis_pass redis;
    }
}



Thanks to:
--

Maxim Dounin
Vsevolod Stakhov
Ezra Zygmuntowicz



Special thanks to:
--
Evan Miller for his "Guide To Nginx Module Development" and "Advanced Topics
In Nginx Module Development"
Valery Kholodkov for his "Nginx modules development"

About

You can use this module to perform simple caching. There are plans to extend this module in the near future. Latest version available at http://people.FreeBSD.org/~osa/ngx_http_redis-0.3.8.tar.gz.

Readme

View license

Activity

Custom properties

4 stars

8 watching

6 forks

Report repository