{"id":15395,"date":"2024-11-17T20:51:41","date_gmt":"2024-11-17T12:51:41","guid":{"rendered":"https:\/\/fwq.ai\/blog\/?p=15395"},"modified":"2024-11-17T20:51:41","modified_gmt":"2024-11-17T12:51:41","slug":"openresty%e4%b8%adngx-shared-dict%e7%9a%84%e7%94%a8%e6%b3%95","status":"publish","type":"post","link":"https:\/\/fwq.ai\/blog\/15395\/","title":{"rendered":"openResty\u4e2dngx.shared.DICT\u7684\u7528\u6cd5"},"content":{"rendered":"<p>ngx_lua \u63d0\u4f9b\u4e86\u4e00\u7cfb\u5217\u5171\u4eab\u5185\u5b58\u76f8\u5173\u7684 API (ngx.shared.DICT)\uff0c\u53ef\u4ee5\u5f88\u65b9\u4fbf\u5730\u901a\u8fc7\u8bbe\u7f6e\u8fc7\u671f\u65f6\u95f4\u6765\u4f7f\u5f97\u7f13\u5b58\u88ab\u52a8\u8fc7\u671f\uff0c\u503c\u5f97\u4e00\u63d0\u7684\u662f\uff0c\u5f53\u7f13\u5b58\u7684\u5bb9\u91cf\u8d85\u8fc7\u9884\u5148\u7533\u8bf7\u7684\u5185\u5b58\u6c60\u5927\u5c0f\u7684\u65f6\u5019\uff0cngx.shared.DICT.set \u65b9\u6cd5\u5219\u4f1a\u5c1d\u8bd5\u4ee5 LRU \u7684\u5f62\u5f0f\u6dd8\u6c70\u4e00\u90e8\u5206\u5185\u5bb9\u3002<\/p>\n<p>&nbsp;<\/p>\n<h2>\u4e00\u3001ngx.shared.DICT<\/h2>\n<p><strong>\u8bed\u6cd5:<\/strong>\u00a0<em>dict = ngx.shared.DICT<br \/>\n<\/em><strong>\u8bed\u6cd5:<\/strong>\u00a0<em>dict = ngx.shared[name_var]<br \/>\n<\/em><strong>\u4f5c\u7528\u57df:<\/strong>\u00a0<em>init_by_lua*, init_worker_by_lua*, set_by_lua*, rewrite_by_lua*, access_by_lua*, content_by_lua*, header_filter_by_lua*, body_filter_by_lua*, log_by_lua*, ngx.timer.*, balancer_by_lua*, ssl_certificate_by_lua*, ssl_session_fetch_by_lua*, ssl_session_store_by_lua*<\/em><\/p>\n<h1>1.1<br \/>\nngx.shared.DICT.set\u3001ngx.shared.DICT.safe_set\u3001ngx.shared.DICT.add\u3001ngx.shared.DICT.safe_add<\/h1>\n<p><strong>\u8bed\u6cd5:<\/strong>\u00a0<em>success, err, forcible = ngx.shared.DICT:set(key, value, exptime?, flags?)<br \/>\n<\/em><strong>\u4f5c\u7528\u57df:<\/strong>\u00a0<em>init_by_lua*, set_by_lua*, rewrite_by_lua*, access_by_lua*, content_by_lua*, header_filter_by_lua*, body_filter_by_lua*, log_by_lua*, ngx.timer.*, balancer_by_lua*, ssl_certificate_by_lua*, ssl_session_fetch_by_lua*, ssl_session_store_by_lua*<\/em><\/p>\n<p>\u201c\u65e0\u6761\u4ef6\u201d\u5730\u5f80\u5171\u4eab\u5185\u5b58\u4e0a\u63d2\u5165key-value\u5bf9\uff0c\u8fd9\u91cc\u8bb2\u7684\u201c\u65e0\u6761\u4ef6\u201d\u6307\u7684\u662f\u4e0d\u7ba1\u5f85\u63d2\u5165\u7684\u5171\u4eab\u5185\u5b58\u4e0a\u662f\u5426\u5df2\u7ecf\u5b58\u5728\u76f8\u540c\u7684key\u3002<\/p>\n<p><strong>\u8fd4\u56de\u503c\uff1a<\/strong><\/p>\n<pre><strong>success\uff1a<\/strong>\u6210\u529f\u63d2\u5165\u4e3atrue\uff0c\u63d2\u5165\u5931\u8d25\u4e3afalse\r\n<strong>err\uff1a<\/strong>\u64cd\u4f5c\u5931\u8d25\u65f6\u7684\u9519\u8bef\u4fe1\u606f\uff0c\u53ef\u80fd\u7c7b\u4f3c\"no memory\"\r\n<strong>forcible\uff1a<\/strong>true\u8868\u660e\u9700\u8981\u901a\u8fc7\u5f3a\u5236\u5220\u9664\uff08LRU\u7b97\u6cd5\uff09\u5171\u4eab\u5185\u5b58\u4e0a\u5176\u4ed6\u5b57\u5178\u9879\u6765\u5b9e\u73b0\u63d2\u5165\uff0cfalse\u8868\u660e\u6ca1\u6709\u5220\u9664\r\n\u5171\u4eab\u5185\u5b58\u4e0a\u7684\u5b57\u5178\u9879\u6765\u5b9e\u73b0\u63d2\u5165\u3002<\/pre>\n<p><strong>\u53c2\u6570<\/strong><em><strong>value<\/strong><\/em><strong>\uff1a<\/strong>\u53ef\u8bbe\u7f6e booleans, numbers, strings, \u6216\u00a0<code>nil\uff1b<br \/>\n<\/code><strong>\u53c2\u6570<em>exptime<\/em>\uff1a<\/strong>\u8868\u660ekey\u7684\u6709\u6548\u671f\u65f6\u95f4\uff0c\u5355\u4f4d\u662f\u79d2\uff08s\uff09\uff0c\u9ed8\u8ba4\u503c\u4e3a0\uff0c\u8868\u660e\u6c38\u8fdc\u4e0d\u4f1a\u8fc7\u671f\uff1b<br \/>\n<strong>\u53c2\u6570flags\uff1a<\/strong>\u662f\u4e00\u4e2a\u7528\u6237\u6807\u5fd7\u503c\uff0c\u4f1a\u5728\u8c03\u7528get\u65b9\u6cd5\u65f6\u540c\u65f6\u83b7\u53d6\u5f97\u5230\u3002<\/p>\n<p><strong>\u8bed\u6cd5:<\/strong>\u00a0<em>ok, err = ngx.shared.DICT:safe_set(key, value, exptime?, flags?)<br \/>\n<\/em><strong>\u4f5c\u7528\u57df:<\/strong>\u00a0<em>init_by_lua*, set_by_lua*, rewrite_by_lua*, access_by_lua*, content_by_lua*, header_filter_by_lua*, body_filter_by_lua*, log_by_lua*, ngx.timer.*, balancer_by_lua*, ssl_certificate_by_lua*, ssl_session_fetch_by_lua*, ssl_session_store_by_lua*<\/em><\/p>\n<p>\u4e0eset\u65b9\u6cd5\u7c7b\u4f3c\uff0c\u533a\u522b\u5728\u4e8e\u4e0d\u4f1a\u5728\u5171\u4eab\u5185\u5b58\u7528\u5b8c\u7684\u60c5\u51b5\u4e0b\uff0c\u901a\u8fc7\u5f3a\u5236\u5220\u9664\uff08LRU\u7b97\u6cd5\uff09\u7684\u65b9\u6cd5\u5b9e\u73b0\u63d2\u5165\u3002\u5982\u679c\u5185\u5b58\u4e0d\u8db3\uff0c\u4f1a\u76f4\u63a5\u8fd4\u56denil\u548cerr\u4fe1\u606f\u201dno memory\u201d\u3002<\/p>\n<p><strong>\u6ce8\u610f\uff1a<\/strong><\/p>\n<pre>set\u548csafe_set\u5171\u540c\u70b9\u662f\uff1a\u5982\u679c\u5f85\u63d2\u5165\u7684key\u5df2\u7ecf\u5b58\u5728\uff0c\u90a3\u4e48key\u5bf9\u5e94\u7684\u539f\u6765\u7684\u503c\u4f1a\u88ab\u65b0\u7684value\u8986\u76d6\uff01<\/pre>\n<p><strong>\u6817\u5b50\uff1a<\/strong><\/p>\n<pre>location \/app\/detail {\r\n    default_type  plain\/text;\r\n    content_by_lua_block {\r\n        ngx.shared.dict:set(\"dog\", \"it is a nice dog!\")\r\n        ngx.shared.dict:safe_set(\"cat\", \"it is a nice cat!\", 0, 1000)\r\n    }\r\n}\r\nlocation \/app\/test {\r\n    default_type  text\/plain;\r\n    content_by_lua_block {\r\n        local value, flags = ngx.shared.dict:get(\"dog\")\r\n        ngx.say(value, flags)\r\n        local value, flags, stale = ngx.shared.dict:get_stale(\"cat\")\r\n        ngx.say(value, flags, stale)\r\n    }\r\n}<\/pre>\n<p><strong>\u8f93\u51fa\uff1a<\/strong><\/p>\n<pre>it is a nice dog! nil\r\nit is a nice cat! 1000 false<\/pre>\n<p><strong>\u8bed\u6cd5:<\/strong>\u00a0<em>success, err, forcible = ngx.shared.DICT:add(key, value, exptime?, flags?)<br \/>\n<\/em><strong>\u4f5c\u7528\u57df:<\/strong>\u00a0<em>init_by_lua*, set_by_lua*, rewrite_by_lua*, access_by_lua*, content_by_lua*, header_filter_by_lua*, body_filter_by_lua*, log_by_lua*, ngx.timer.*, balancer_by_lua*, ssl_certificate_by_lua*, ssl_session_fetch_by_lua*, ssl_session_store_by_lua*<\/em><\/p>\n<p>\u4e0eset\u65b9\u6cd5\u7c7b\u4f3c\uff0c\u4e0eset\u65b9\u6cd5\u533a\u522b\u5728\u4e8e\u4e0d\u4f1a\u63d2\u5165\u91cd\u590d\u7684\u952e\uff08\u53ef\u4ee5\u7b80\u5355\u8ba4\u4e3aadd\u65b9\u6cd5\u662fset\u65b9\u6cd5\u7684\u4e00\u4e2a\u5b50\u65b9\u6cd5\uff09\uff0c\u5982\u679c\u5f85\u63d2\u5165\u7684key\u5df2\u7ecf\u5b58\u5728\uff0c\u5c06\u4f1a\u8fd4\u56denil\u548c\u548cerr=\u201dexists\u201d<\/p>\n<p><strong>\u8bed\u6cd5:<\/strong>\u00a0<em>ok, err = ngx.shared.DICT:safe_add(key, value, exptime?, flags?)<br \/>\n<\/em><strong>\u4f5c\u7528\u57df:<\/strong>\u00a0<em>init_by_lua*, set_by_lua*, rewrite_by_lua*, access_by_lua*, content_by_lua*, header_filter_by_lua*, body_filter_by_lua*, log_by_lua*, ngx.timer.*, balancer_by_lua*, ssl_certificate_by_lua*, ssl_session_fetch_by_lua*, ssl_session_store_by_lua*<\/em><\/p>\n<p>\u4e0esafe_set\u65b9\u6cd5\u7c7b\u4f3c\uff0c\u533a\u522b\u5728\u4e8e\u4e0d\u4f1a\u63d2\u5165\u91cd\u590d\u7684\u952e\uff08\u53ef\u4ee5\u7b80\u5355\u8ba4\u4e3asafe_add\u65b9\u6cd5\u662fsafe_set\u65b9\u6cd5\u7684\u4e00\u4e2a\u5b50\u65b9\u6cd5\uff09\uff0c\u5982\u679c\u5f85\u63d2\u5165\u7684key\u5df2\u7ecf\u5b58\u5728\uff0c\u5c06\u4f1a\u8fd4\u56denil\u548c\u548cerr=\u201dexists\u201d<\/p>\n<h1>1.2 ngx.shared.DICT.get\u3001ngx.shared.DICT.get_stale<\/h1>\n<p><strong>\u8bed\u6cd5:<\/strong>\u00a0<em>value, flags = ngx.shared.DICT:get(key)<br \/>\n<\/em><strong>\u4f5c\u7528\u57df:<\/strong>\u00a0<em>set_by_lua*, rewrite_by_lua*, access_by_lua*, content_by_lua*, header_filter_by_lua*, body_filter_by_lua*, log_by_lua*, ngx.timer.*, balancer_by_lua*, ssl_certificate_by_lua*, ssl_session_fetch_by_lua*, ssl_session_store_by_lua*<\/em><\/p>\n<p>\u83b7\u53d6\u5171\u4eab\u5185\u5b58\u4e0akey\u5bf9\u5e94\u7684\u503c\u3002\u5982\u679ckey\u4e0d\u5b58\u5728\uff0c\u6216\u8005key\u5df2\u7ecf\u8fc7\u671f\uff0c\u5c06\u4f1a\u8fd4\u56denil\uff1b\u5982\u679c\u51fa\u73b0\u9519\u8bef\uff0c\u90a3\u4e48\u5c06\u4f1a\u8fd4\u56denil\u4ee5\u53ca\u9519\u8bef\u4fe1\u606f\u3002<\/p>\n<p>\u8fd4\u56de\u5217\u8868\u4e2d\u7684flags\uff0c\u662f\u5728ngx.shared.DICT.set\u65b9\u6cd5\u4e2d\u8bbe\u7f6e\u7684\u503c\uff0c\u9ed8\u8ba4\u503c\u4e3a0. \u5982\u679c\u8bbe\u7f6e\u7684flags\u4e3a0\uff0c\u90a3\u4e48\u5728\u8fd9\u91ccflags\u7684\u503c\u5c06\u4e0d\u4f1a\u88ab\u8fd4\u56de\u3002<\/p>\n<p><strong>\u8bed\u6cd5:<\/strong>\u00a0<em>value, flags, stale = ngx.shared.DICT:get_stale(key)<br \/>\n<\/em><strong>\u4f5c\u7528\u57df:<\/strong>\u00a0<em>set_by_lua*, rewrite_by_lua*, access_by_lua*, content_by_lua*, header_filter_by_lua*, body_filter_by_lua*, log_by_lua*, ngx.timer.*, balancer_by_lua*, ssl_certificate_by_lua*, ssl_session_fetch_by_lua*, ssl_session_store_by_lua*<\/em><\/p>\n<p>\u4e0eget\u65b9\u6cd5\u7c7b\u4f3c\uff0c\u533a\u522b\u5728\u4e8e\u8be5\u65b9\u6cd5\u5bf9\u4e8e\u8fc7\u671f\u7684key\u4e5f\u4f1a\u8fd4\u56de\uff0c\u7b2c\u4e09\u4e2a\u8fd4\u56de\u53c2\u6570\u8868\u660e\u8fd4\u56de\u7684key\u7684\u503c\u662f\u5426\u5df2\u7ecf\u8fc7\u671f\uff0ctrue\u8868\u793a\u8fc7\u671f\uff0cfalse\u8868\u793a\u6ca1\u6709\u8fc7\u671f\u3002<\/p>\n<h1>1.3 ngx.shared.DICT.replace<\/h1>\n<p><strong>\u8bed\u6cd5:<\/strong>\u00a0<em>success, err, forcible = ngx.shared.DICT:replace(key, value, exptime?, flags?)<br \/>\n<\/em><strong>\u4f5c\u7528\u57df:<\/strong>\u00a0<em>init_by_lua*, set_by_lua*, rewrite_by_lua*, access_by_lua*, content_by_lua*, header_filter_by_lua*, body_filter_by_lua*, log_by_lua*, ngx.timer.*, balancer_by_lua*, ssl_certificate_by_lua*, ssl_session_fetch_by_lua*, ssl_session_store_by_lua*<\/em><\/p>\n<p>\u4e0eset\u65b9\u6cd5\u7c7b\u4f3c\uff0c\u533a\u522b\u5728\u4e8e\u53ea\u5bf9\u5df2\u7ecf\u5b58\u5728\u7684key\u8fdb\u884c\u64cd\u4f5c\uff08\u53ef\u4ee5\u7b80\u5355\u8ba4\u4e3areplace\u65b9\u6cd5\u662fset\u65b9\u6cd5\u7684\u4e00\u4e2a\u5b50\u65b9\u6cd5\uff09\uff0c\u5982\u679c\u5f85\u63d2\u5165\u7684key\u5728\u5b57\u5178\u4e0a\u4e0d\u5b58\u5728\uff0c\u5c06\u4f1a\u8fd4\u56denil\u548c\u9519\u8bef\u4fe1\u606f\u201dnot found\u201d<\/p>\n<h1>1.4 ngx.shared.DICT.delete<\/h1>\n<p><strong>\u8bed\u6cd5:<\/strong>\u00a0<em>ngx.shared.DICT:delete(key)<br \/>\n<\/em><strong>\u4f5c\u7528\u57df:<\/strong>\u00a0<em>init_by_lua*, set_by_lua*, rewrite_by_lua*, access_by_lua*, content_by_lua*, header_filter_by_lua*, body_filter_by_lua*, log_by_lua*, ngx.timer.*, balancer_by_lua*, ssl_certificate_by_lua*, ssl_session_fetch_by_lua*, ssl_session_store_by_lua*<\/em><\/p>\n<p>\u65e0\u6761\u4ef6\u5220\u9664\u6307\u5b9a\u7684key-value\u5bf9\uff0c\u5176\u7b49\u4ef7\u4e8e ngx.shared.DICT:set(key, nil)<\/p>\n<h1>1.5 ngx.shared.DICT.incr<\/h1>\n<p><strong>\u8bed\u6cd5:<\/strong>\u00a0<em>newval, err, forcible? = ngx.shared.DICT:incr(key, value, init?)<br \/>\n<\/em><strong>\u4f5c\u7528\u57df:<\/strong>\u00a0<em>init_by_lua*, set_by_lua*, rewrite_by_lua*, access_by_lua*, content_by_lua*, header_filter_by_lua*, body_filter_by_lua*, log_by_lua*, ngx.timer.*, balancer_by_lua*, ssl_certificate_by_lua*, ssl_session_fetch_by_lua*, ssl_session_store_by_lua*<\/em><\/p>\n<p>\u5bf9key\u5bf9\u5e94\u7684\u503c\u8fdb\u884c\u589e\u91cf\u64cd\u4f5c\uff0c\u589e\u91cf\u503c\u662fvalue\uff0c\u5176\u4e2dvalue\u7684\u503c\u53ef\u4ee5\u662f\u4e00\u4e2a\u6b63\u6570\uff0c0\uff0c\u4e5f\u53ef\u4ee5\u662f\u4e00\u4e2a\u8d1f\u6570\u3002value\u5fc5\u987b\u662f\u4e00\u4e2aLua\u7c7b\u578b\u4e2d\u7684number\u7c7b\u578b\uff0c\u5426\u5219\u5c06\u4f1a\u8fd4\u56denil\u548c\u201dnot a number\u201d\uff1bkey\u5fc5\u987b\u662f\u4e00\u4e2a\u5df2\u7ecf\u5b58\u5728\u4e8e\u5171\u4eab\u5185\u5b58\u4e2d\u7684key\uff0c\u5426\u5219\u5c06\u4f1a\u8fd4\u56denil\u548c\u201dnot found\u201d.<\/p>\n<h1>1.6<br \/>\nngx.shared.DICT.lpush\u3001ngx.shared.DICT.rpush\u3001ngx.shared.DICT.lpop\u3001ngx.shared.DICT.rpop<\/h1>\n<p><strong>\u8bed\u6cd5:<\/strong>\u00a0<em>length, err = ngx.shared.DICT:lpush(key, value)<br \/>\n<\/em><strong>\u4f5c\u7528\u57df:<\/strong>\u00a0<em>init_by_lua*, set_by_lua*, rewrite_by_lua*, access_by_lua*, content_by_lua*, header_filter_by_lua*, body_filter_by_lua*, log_by_lua*, ngx.timer.*, balancer_by_lua*, ssl_certificate_by_lua*, ssl_session_fetch_by_lua*, ssl_session_store_by_lua*<\/em><\/p>\n<p><strong>\u8bed\u6cd5:<\/strong>\u00a0<em>length, err = ngx.shared.DICT:rpush(key, value)<br \/>\n<\/em><strong>\u4f5c\u7528\u57df:<\/strong>\u00a0<em>init_by_lua*, set_by_lua*, rewrite_by_lua*, access_by_lua*, content_by_lua*, header_filter_by_lua*, body_filter_by_lua*, log_by_lua*, ngx.timer.*, balancer_by_lua*, ssl_certificate_by_lua*, ssl_session_fetch_by_lua*, ssl_session_store_by_lua*<\/em><\/p>\n<p><strong>\u8bed\u6cd5:<\/strong>\u00a0<em>val, err = ngx.shared.DICT:lpop(key)<br \/>\n<\/em><strong>\u4f5c\u7528\u57df:<\/strong>\u00a0<em>init_by_lua*, set_by_lua*, rewrite_by_lua*, access_by_lua*, content_by_lua*, header_filter_by_lua*, body_filter_by_lua*, log_by_lua*, ngx.timer.*, balancer_by_lua*, ssl_certificate_by_lua*, ssl_session_fetch_by_lua*, ssl_session_store_by_lua*<\/em><\/p>\n<p><strong>\u8bed\u6cd5:<\/strong>\u00a0<em>val, err = ngx.shared.DICT:rpop(key)<br \/>\n<\/em><strong>\u4f5c\u7528\u57df:<\/strong>\u00a0<em>init_by_lua*, set_by_lua*, rewrite_by_lua*, access_by_lua*, content_by_lua*, header_filter_by_lua*, body_filter_by_lua*, log_by_lua*, ngx.timer.*, balancer_by_lua*, ssl_certificate_by_lua*, ssl_session_fetch_by_lua*, ssl_session_store_by_lua*<\/em><\/p>\n<h1>\u00a01.7 ngx.shared.DICT.ttl<\/h1>\n<p><strong>\u8bed\u6cd5:<\/strong>\u00a0<em>ttl, err = ngx.shared.DICT:ttl(key)<br \/>\n<\/em><strong>\u4f5c\u7528\u57df:<\/strong>\u00a0<em>init_by_lua*, set_by_lua*, rewrite_by_lua*, access_by_lua*, content_by_lua*, header_filter_by_lua*, body_filter_by_lua*, log_by_lua*, ngx.timer.*, balancer_by_lua*, ssl_certificate_by_lua*, ssl_session_fetch_by_lua*, ssl_session_store_by_lua*<br \/>\n<\/em><strong>requires:<\/strong>\u00a0<code>resty.core.shdict<\/code>\u00a0or\u00a0<code>resty.core<\/code><\/p>\n<h1>1.8 ngx.shared.DICT.expire<\/h1>\n<p><strong>\u8bed\u6cd5:<\/strong>\u00a0<em>success, err = ngx.shared.DICT:expire(key, exptime)<br \/>\n<\/em><strong>\u4f5c\u7528\u57df:<\/strong>\u00a0<em>init_by_lua*, set_by_lua*, rewrite_by_lua*, access_by_lua*, content_by_lua*, header_filter_by_lua*, body_filter_by_lua*, log_by_lua*, ngx.timer.*, balancer_by_lua*, ssl_certificate_by_lua*, ssl_session_fetch_by_lua*, ssl_session_store_by_lua*<br \/>\n<\/em><strong>requires:<\/strong>\u00a0<code>resty.core.shdict<\/code>\u00a0or\u00a0<code>resty.core<\/code><\/p>\n<h1>1.9 ngx.shared.DICT.flush_all<\/h1>\n<p><strong>\u8bed\u6cd5:<\/strong>\u00a0<em>ngx.shared.DICT:flush_all()<br \/>\n<\/em><strong>\u4f5c\u7528\u57df:<\/strong>\u00a0<em>init_by_lua*, set_by_lua*, rewrite_by_lua*, access_by_lua*, content_by_lua*, header_filter_by_lua*, body_filter_by_lua*, log_by_lua*, ngx.timer.*, balancer_by_lua*, ssl_certificate_by_lua*, ssl_session_fetch_by_lua*, ssl_session_store_by_lua*<\/em><\/p>\n<h1>1.10 ngx.shared.DICT.flush_expired<\/h1>\n<p><strong>\u8bed\u6cd5:<\/strong>\u00a0<em>flushed = ngx.shared.DICT:flush_expired(max_count?)<br \/>\n<\/em><strong>\u4f5c\u7528\u57df:<\/strong>\u00a0<em>init_by_lua*, set_by_lua*, rewrite_by_lua*, access_by_lua*, content_by_lua*, header_filter_by_lua*, body_filter_by_lua*, log_by_lua*, ngx.timer.*, balancer_by_lua*, ssl_certificate_by_lua*, ssl_session_fetch_by_lua*, ssl_session_store_by_lua*<\/em><\/p>\n<h1>1.11 ngx.shared.DICT.get_keys<\/h1>\n<p><strong>\u8bed\u6cd5:<\/strong>\u00a0<em>keys = ngx.shared.DICT:get_keys(max_count?)<br \/>\n<\/em><strong>\u4f5c\u7528\u57df:<\/strong>\u00a0<em>init_by_lua*, set_by_lua*, rewrite_by_lua*, access_by_lua*, content_by_lua*, header_filter_by_lua*, body_filter_by_lua*, log_by_lua*, ngx.timer.*, balancer_by_lua*, ssl_certificate_by_lua*, ssl_session_fetch_by_lua*, ssl_session_store_by_lua*<\/em><\/p>\n<h1>1.12 ngx.shared.DICT.capacity<\/h1>\n<p><strong>\u8bed\u6cd5:<\/strong>\u00a0<em>capacity_bytes = ngx.shared.DICT:capacity()<br \/>\n<\/em><strong>\u4f5c\u7528\u57df:<\/strong>\u00a0<em>init_by_lua*, set_by_lua*, rewrite_by_lua*, access_by_lua*, content_by_lua*, header_filter_by_lua*, body_filter_by_lua*, log_by_lua*, ngx.timer.*, balancer_by_lua*, ssl_certificate_by_lua*, ssl_session_fetch_by_lua*, ssl_session_store_by_lua*<br \/>\n<\/em><strong>requires:<\/strong>\u00a0<code>resty.core.shdict<\/code>\u00a0or\u00a0<code>resty.core<\/code><\/p>\n<h1>1.13 ngx.shared.DICT.free_space<\/h1>\n<p><strong>\u8bed\u6cd5:<\/strong>\u00a0<em>free_page_bytes = ngx.shared.DICT:free_space()<br \/>\n<\/em><strong>\u4f5c\u7528\u57df:<\/strong>\u00a0<em>init_by_lua*, set_by_lua*, rewrite_by_lua*, access_by_lua*, content_by_lua*, header_filter_by_lua*, body_filter_by_lua*, log_by_lua*, ngx.timer.*, balancer_by_lua*, ssl_certificate_by_lua*, ssl_session_fetch_by_lua*, ssl_session_store_by_lua*<br \/>\n<\/em><strong>requires:<\/strong>\u00a0<code>resty.core.shdict<\/code>\u00a0or\u00a0<code>resty.core<\/code><\/p>\n","protected":false},"excerpt":{"rendered":"<p>ngx_lua \u63d0\u4f9b\u4e86\u4e00\u7cfb\u5217\u5171\u4eab\u5185\u5b58\u76f8\u5173\u7684 API (ngx.shared.DICT)\uff0c\u53ef\u4ee5\u5f88\u65b9\u4fbf\u5730\u901a\u8fc7\u8bbe\u7f6e\u8fc7\u671f\u65f6\u95f4\u6765\u4f7f\u5f97\u7f13\u5b58\u88ab\u52a8\u8fc7\u671f\uff0c\u503c\u5f97\u4e00\u63d0\u7684\u662f\uff0c\u5f53\u7f13\u5b58\u7684\u5bb9\u91cf\u8d85\u8fc7\u9884\u5148\u7533\u8bf7\u7684\u5185\u5b58\u6c60\u5927\u5c0f\u7684\u65f6\u5019\uff0cngx.shared.DICT.set \u65b9\u6cd5\u5219\u4f1a\u5c1d\u8bd5\u4ee5 LRU \u7684\u5f62\u5f0f\u6dd8\u6c70\u4e00\u90e8\u5206\u5185\u5bb9\u3002 &nbsp; \u4e00\u3001ngx.shared.DICT \u8bed\u6cd5:\u00a0dict = ngx.shared.DICT \u8bed\u6cd5:\u00a0dict = ngx.shared[name_var] \u4f5c\u7528\u57df:\u00a0init_by_lua*, init_worker_by_lua*, set_by_lua*, rewrite_by_lua*, access_by_lua*, content_by_lua*, header_filter_by_lua*, body_filter_by_lua*, log_by_lua*, ngx.timer.*, balancer_by_lua*, ssl_certificate_by_lua*, ssl_session_fetch_by_lua*, ssl_session_store_by_lua* 1.1 ngx.shared.DICT.set\u3001ngx.shared.DICT.safe_set\u3001ngx.shared.DICT.add\u3001ngx.shared.DICT.safe_add \u8bed\u6cd5:\u00a0success, err, forcible = ngx.shared.DICT:set(key, value, exptime?, flags?) \u4f5c\u7528\u57df:\u00a0init_by_lua*, set_by_lua*, rewrite_by_lua*, access_by_lua*, content_by_lua*, header_filter_by_lua*, body_filter_by_lua*, log_by_lua*, ngx.timer.*, balancer_by_lua*, ssl_certificate_by_lua*, ssl_session_fetch_by_lua*, ssl_session_store_by_lua* \u201c\u65e0\u6761\u4ef6\u201d\u5730\u5f80\u5171\u4eab\u5185\u5b58\u4e0a\u63d2\u5165key-value\u5bf9\uff0c\u8fd9\u91cc\u8bb2\u7684\u201c\u65e0\u6761\u4ef6\u201d\u6307\u7684\u662f\u4e0d\u7ba1\u5f85\u63d2\u5165\u7684\u5171\u4eab\u5185\u5b58\u4e0a\u662f\u5426\u5df2\u7ecf\u5b58\u5728\u76f8\u540c\u7684key\u3002 \u8fd4\u56de\u503c\uff1a success\uff1a\u6210\u529f\u63d2\u5165\u4e3atrue\uff0c\u63d2\u5165\u5931\u8d25\u4e3afalse [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[17],"tags":[],"class_list":["post-15395","post","type-post","status-publish","format-standard","hentry","category-docker"],"_links":{"self":[{"href":"https:\/\/fwq.ai\/blog\/wp-json\/wp\/v2\/posts\/15395","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/fwq.ai\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/fwq.ai\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/fwq.ai\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/fwq.ai\/blog\/wp-json\/wp\/v2\/comments?post=15395"}],"version-history":[{"count":1,"href":"https:\/\/fwq.ai\/blog\/wp-json\/wp\/v2\/posts\/15395\/revisions"}],"predecessor-version":[{"id":15396,"href":"https:\/\/fwq.ai\/blog\/wp-json\/wp\/v2\/posts\/15395\/revisions\/15396"}],"wp:attachment":[{"href":"https:\/\/fwq.ai\/blog\/wp-json\/wp\/v2\/media?parent=15395"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/fwq.ai\/blog\/wp-json\/wp\/v2\/categories?post=15395"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/fwq.ai\/blog\/wp-json\/wp\/v2\/tags?post=15395"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}