小薛博客

Appearance

::: note

这里是 ngx_lua 模块的文档表总结。

:::

OpenRestry 中文文档

常量 ​

常量说明
Core constantsngx.OK　　　　　　　(0)
ngx.ERROR　　　　　(-1)
ngx.AGAIN　　　　　(-2)
ngx.DONE　　　　　(-4)
ngx.DECLINED　　　(-5)
ngx.nil
HTTP method constantsngx.HTTP_GET
ngx.HTTP_HEAD
ngx.HTTP_PUT
ngx.HTTP_POST
ngx.HTTP_DELETE
ngx.HTTP_OPTIONS
ngx.HTTP_MKCOL
ngx.HTTP_COPY
ngx.HTTP_MOVE
ngx.HTTP_PROPFIND
ngx.HTTP_PROPPATCH
ngx.HTTP_LOCK
ngx.HTTP_UNLOCK
ngx.HTTP_PATCH
ngx.HTTP_TRACE
HTTP status constantsngx.HTTP_OK　　　　　　　　　　　　　　(200)
ngx.HTTP_CREATED　　　　　　　　　　　 (201)
ngx.HTTP_SPECIAL_RESPONSE　　　　　　　(300)
ngx.HTTP_MOVED_PERMANENTLY　　　　　(301)
ngx.HTTP_MOVED_TEMPORARILY　　　　　(302)
ngx.HTTP_SEE_OTHER　　　　　　　　　　(303)
ngx.HTTP_NOT_MODIFIED　　　　　　　　(304)
ngx.HTTP_BAD_REQUEST　　　　　　　　　(400)
ngx.HTTP_UNAUTHORIZED　　　　　　　　(401)
ngx.HTTP_FORBIDDEN　　　　　　　　　　(403)
ngx.HTTP_NOT_FOUND　　　　　　　　　　(404)
ngx.HTTP_NOT_ALLOWED　　　　　　　　　(405)
ngx.HTTP_GONE　　　　　　　　　　　　　(410)
ngx.HTTP_INTERNAL_SERVER_ERROR　　　　(500)
ngx.HTTP_METHOD_NOT_IMPLEMENTED　　(501)
ngx.HTTP_SERVICE_UNAVAILABLE　　　　　　(503)
ngx.HTTP_GATEWAY_TIMEOUT　　　　　　　(504)
Nginx log level constantsngx.STDERR
ngx.EMERG
ngx.ALERT
ngx.CRIT
ngx.ERR
ngx.WARN
ngx.NOTICE
ngx.INFO
ngx.DEBUG

API ​

API说明
ngx.arg指令参数，如跟在 content_by_lua_file 后面的参数
ngx.var变量，ngx.var.VARIABLE 引用某个变量
ngx.ctx请求的 lua 上下文
ngx.header响应头，ngx.header.HEADER 引用某个头
ngx.status响应码
ngx.log输出到 error.log
print等价于 ngx.log(ngx.NOTICE, ...)
ngx.send_headers发送响应头
ngx.headers_sent响应头是否已发送
ngx.resp.get_headers获取响应头
ngx.timer.at注册定时器事件
ngx.is_subrequest当前请求是否是子请求
ngx.location.capture发布一个子请求
ngx.location.capture_multi发布多个子请求
ngx.exec执行一个内部 localtion 模块跳转
ngx.redirect
ngx.print输出响应
ngx.say输出响应，自动添加『 \n 』
ngx.flush刷新响应
ngx.exit结束请求
ngx.eof
ngx.sleep无阻塞的休眠（使用定时器实现）
ngx.get_phase
ngx.on_abort注册 client 断开请求时的回调函数
ndk.set_var.DIRECTIVE
ngx.req.start_time请求的开始时间
ngx.req.http_version请求的 HTTP 版本号
ngx.req.raw_header请求头（包括请求行）
ngx.req.get_method请求方法
ngx.req.set_method请求方法重载
ngx.req.set_uri请求URL重写
ngx.req.set_uri_args
ngx.req.get_uri_args获取请求参数
ngx.req.get_post_args获取请求表单
ngx.req.get_headers获取请求头
ngx.req.set_header设置数据到请求头
ngx.req.clear_header清除请求头数据
ngx.req.read_body读取请求体
ngx.req.discard_body扔掉请求体
ngx.req.get_body_data获取请求体数据
ngx.req.get_body_file后面跟 lua 文件
ngx.req.set_body_data设置数据到请求体
ngx.req.set_body_file
ngx.req.init_body
ngx.req.append_body
ngx.req.finish_body
ngx.req.socket
ngx.escape_uri字符串的 URL 编码
ngx.unescape_uri字符串 URL 解码
ngx.encode_args将 table 编码为一个参数字符串
ngx.decode_args将参数字符串编码为一个t able
ngx.encode_base64字符串的 base64 编码
ngx.decode_base64字符串的 base64 解码
ngx.crc32_short字符串的 crs32_short 哈希
ngx.crc32_long字符串的 crs32_long 哈希
ngx.hmac_sha1字符串的 hmac_sha1 哈希
ngx.md5返回 16 进制 MD5
ngx.md5_bin返回 2 进制 MD5
ngx.sha1_bin返回 2 进制 sha1 哈希值
ngx.quote_sql_strSQL 语句转义，防止 SQL 注入
ngx.today返回当前日期
ngx.time返回 UNIX 时间戳
ngx.now返回当前时间
ngx.update_time刷新时间后再返回
ngx.localtime返回本地系统时间
ngx.utctime返回 nginx 时间缓存
ngx.cookie_time返回的时间可用于 cookie 值
ngx.http_time返回的时间可用于 HTTP 头
ngx.parse_http_time解析 HTTP 头的时间
ngx.re.match使用 Perl 兼容正则表达式匹配字符串
ngx.re.find返回匹配结果子字符串的开始索引 (from) 和结束索引 (to)
ngx.re.gmatch返回一个 Lua 迭代器
ngx.re.sub
ngx.re.gsub执行全局替换
ngx.shared.DICT获取基于共享内存名为 DICT 的 Lua 字典对象，它是一个共享内存区块
ngx.shared.DICT.get从字典中获取名为键 (key) 值
ngx.shared.DICT.get_stale
ngx.shared.DICT.set
ngx.shared.DICT.safe_set
ngx.shared.DICT.add
ngx.shared.DICT.safe_add
ngx.shared.DICT.replace
ngx.shared.DICT.delete
ngx.shared.DICT.incr
ngx.shared.DICT.flush_all
ngx.shared.DICT.flush_expired
ngx.shared.DICT.get_keys
ngx.socket.udp
udpsock:setpeername
udpsock:send
udpsock:receive
udpsock:close
udpsock:settimeout
ngx.socket.tcp
tcpsock:connect
tcpsock:sslhandshake
tcpsock:send
tcpsock:receive
tcpsock:receiveuntil
tcpsock:close
tcpsock:settimeout
tcpsock:setoption
tcpsock:setkeepalive
tcpsock:getreusedtimes
ngx.socket.connect
ngx.thread.spawn
ngx.thread.wait
ngx.thread.kill
coroutine.create
coroutine.resume
coroutine.yield
coroutine.wrap
coroutine.running
coroutine.status
ngx.config.debug编译时是否有 --with-debug 选项
ngx.config.prefix编译时的 --prefix 选项
ngx.config.nginx_version返回 Nginx 版本号
ngx.config.nginx_configure返回编译时 ./configure 的命令行选项
ngx.config.ngx_lua_version返回 ngx_lua 模块版本号
ngx.worker.exiting当前 worker 进程是否正在关闭（如reload、shutdown期间）
ngx.worker.pid返回当前 worker 进程的 pid

指令 ​

指令名称说明
lua_use_default_type是否使用 default_type 指令定义的 Content-Type 默认值
lua_code_cache*_by_lua_file 文件是否 cache
lua_regex_cache_max_entries
lua_regex_match_limit
lua_package_path用 Lua 写的 lua 外部库路径（.lua文件）
lua_package_cpath用 C 写的 lua 外部库路径（.so文件）
init_by_luamaster 进程启动时挂载的 lua 代码
init_by_lua_file
init_worker_by_luaworker 进程启动时挂载的 lua 代码，常用来执行一些定时器任务
init_worker_by_lua_file
set_by_lua设置变量
set_by_lua_file
content_by_luahandler 模块
content_by_lua_file
rewrite_by_lua
rewrite_by_lua_file
access_by_lua
access_by_lua_file
header_filter_by_luaheader filter 模块
header_filter_by_lua_file
body_filter_by_luabody filter 模块，ngx.arg[1]代表输入的 chunk，ngx.arg[2] 代表当前 chunk 是否为 last
body_filter_by_lua_file
log_by_lua
log_by_lua_file
lua_need_request_body是否读请求体，跟 ngx.req.read_body() 函数作用类似
lua_shared_dict创建全局共享的 table（多个 worker 进程共享）
lua_socket_connect_timeoutTCP/unix 域 socket 对象 connect 方法的超时时间
lua_socket_send_timeoutTCP/unix 域 socket 对象 send 方法的超时时间
lua_socket_send_lowat设置 cosocket send buffer 的 low water 值
lua_socket_read_timeoutTCP/unix 域 socket 对象r eceive 方法的超时时间
lua_socket_buffer_sizecosocket 读 buffer 大小
lua_socket_pool_sizecosocket 连接池大小
lua_socket_keepalive_timeoutcosocket 长连接超时时间
lua_socket_log_errors是否打开 cosocket 错误日志
lua_ssl_ciphers
lua_ssl_crl
lua_ssl_protocols
ua_ssl_trusted_certificate
lua_ssl_verify_depth
lua_http10_buffering
rewrite_by_lua_no_postpone
lua_transform_underscores_in_response_headers
lua_check_client_abort是否监视 client 提前关闭请求的事件，如果打开监视，会调用 ngx.on_abort() 注册的回调
lua_max_pending_timers
lua_max_running_timers