lua_shared_dict

1.定义一块名为my_cache的共享内存空间，内存大小为size。
2.通过该命令定义的共享内存对象对于Nginx中所有worker进程都是可见的
3.当Nginx通过reload命令重启时，共享内存字典项会从新获取它的内容
4.当时当Nginx退出时，字典项的值将会丢失

http{
  lua_shared_dict my_cache 128m;
  ...
}

safe_set类似 set 方法，但当共享内存区块存储空间不足时，不覆盖 (最近最少使用的) 有效的项 (非过期项)。此时，它将返回 nil 和字符串 "no memory" (内存不足)。

local my_cache = ngx.shared.my_cache;
local succ, err, forcible = my_cache:safe_set("a",1)
if not succ then
  ngx.say("set fail,err:"..err.."考虑增加空间")
  return
end
ngx.say(my_cache:get("a"))

1

5

add类似 set 方法，但仅当存储字典 ngx.shared.DICT 中 不存在 该 key 时执行存储 key-value 对。
如果参数 key 在字典中已经存在 (且没有过期)，success 返回值为 false，同时 err 返回 "exist" (已存在)。

local succ, err, forcible = my_cache:safe_add("a",2)
if not succ then
  ngx.say("add fail,err:"..err)
  return
end

1
add fail,err:exists

清空:

my_cache:flush_all()--这个不释放内存,而是标记过期,不过可能会不定期的flush_expired,所以不要依赖已过期项的可用性
--清除字典中已过期的的内容，最多清除可选参数 max_count (最大数量) 个。当参数 max_count 值为 0 或者未指定时，意为无数量限制。返回值为实际清除的数量
local expired_count = my_cache:flush_expired()
ngx.say(expired_count)