it assumes that you're using some slower external lookup (memc, *sql, redis, etc) that you want to cache the result of, inside your ngx_lua application code. it aims at : being very simple to use from ...

Creates an shcache object which implements the caching state machine in the attached documents ngx.shared.DICT is the shared dictionnary (declared in Nginx conf by lua_shared_dict directive) to use ...