https://github.com/lloydzhou/lua-resty-cache

http cache to redis, can server stale response, and using "lua-resty-lock" only allow one request to populate a new cache
https://github.com/lloydzhou/lua-resty-cache

Last synced: 9 days ago
JSON representation

http cache to redis, can server stale response, and using "lua-resty-lock" only allow one request to populate a new cache

• Host: GitHub
• URL: https://github.com/lloydzhou/lua-resty-cache
• Owner: lloydzhou
• Created: 2015-07-07T07:06:08.000Z (over 9 years ago)
• Default Branch: feature-srcache
• Last Pushed: 2015-11-22T14:46:50.000Z (almost 9 years ago)
• Last Synced: 2024-04-16T15:08:04.406Z (7 months ago)
• Language: Lua
• Size: 17.6 KB
• Stars: 56
• Watchers: 6
• Forks: 19
• Open Issues: 3
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-resty - lua-resty-cache - resty-lock` only allow one request to populate a new cache (Libraries)

README

        
# lua-resty-cache

one lua library to work with srcache, can server stale response, and using "lua-resty-lock" only allow one request to populate a new cache.

1. if the cache is missing, skip the srcache_fetch, and make single request to populate a new cache, the other request with same cache_key, just wait update cache success.

2. always set the redis expires to (real expires time + stale time), so can find the stale data from reids.

3. if get stale data from redis, just send stale data to client(using ngx.eof(), the client can close this connection.)

4. and then make subrequest to populate a new cache (using lua-resty-lock, so only one request send to backend server).

## Install

    git clone --branch feature-srcache --recursive https://github.com/lloydzhou/lua-resty-cache

    cd lua-resty-cache && sudo make install

## Synopsis

    upstream www {

        server 127.0.0.1:9999;

    }

    upstream redis {

        server 127.0.0.1:6379;

        keepalive 1024;

    }

    lua_shared_dict srcache_locks 1m;

    location /api {

        set $cache_lock srcache_locks;

        set $cache_ttl /redisttl;

        set $cache_persist /redispersist;

        set $cache_key "$http_user_agent|$uri";

        set $cache_stale 100;

        set $cache_lock_exptime 30;

        set $cache_backend_lock_timeout 0.01;

        set $cache_lock_timeout 3;

        set $cache_lock_timeout_wait 0.06;

        set $cache_skip_fetch "X-Skip-Fetch";

        set_escape_uri $escaped_key $cache_key;

        

        rewrite_by_lua_file /usr/local/openresty/lualib/resty/cache.lua;

        

        if ($http_x_skip_fetch != TRUE){ srcache_fetch GET /redis $cache_key;}

        srcache_store PUT /redis2 key=$escaped_key&exptime=105;

        add_header X-Cache $srcache_fetch_status;

        add_header X-Store $srcache_store_status;

        #echo hello world;

        proxy_pass http://www;

    }

    location = /redisttl {

        internal;

        set_unescape_uri $key $arg_key;

        set_md5 $key;

        redis2_query ttl $key;

        redis2_pass redis;

    }

    location = /redispersist {

        internal;

        set_unescape_uri $key $arg_key;

        set_md5 $key;

        redis2_query persist $key;

        redis2_pass redis;

    }

    location = /redis {

        internal;

        set_md5 $redis_key $args;

        redis_pass redis;

    }

    location = /redis2 {

        internal;

        set_unescape_uri $exptime $arg_exptime;

        set_unescape_uri $key $arg_key;

        set_md5 $key;

        redis2_query set $key $echo_request_body;

        redis2_query expire $key $exptime;

        redis2_pass redis;

    }