openresty ngx_lua执行阶段
openresty ngx_lua执行阶段
nginx http执行阶段
nginx http执行阶段
# ngx_http_core_module.h
typedef enum {
NGX_HTTP_POST_READ_PHASE = 0,
NGX_HTTP_SERVER_REWRITE_PHASE,
NGX_HTTP_FIND_CONFIG_PHASE,
NGX_HTTP_REWRITE_PHASE,
NGX_HTTP_POST_REWRITE_PHASE,
NGX_HTTP_PREACCESS_PHASE,
NGX_HTTP_ACCESS_PHASE,
NGX_HTTP_POST_ACCESS_PHASE,
NGX_HTTP_PRECONTENT_PHASE,
NGX_HTTP_CONTENT_PHASE,
NGX_HTTP_LOG_PHASE
} ngx_http_phases;
执行阶段说明
NGX_HTTP_POST_READ_PHASE = 0,
* 接受并读取请求
NGX_HTTP_SERVER_REWRITE_PHASE,
* 修改url阶段，通常有重定向、变量设置
NGX_HTTP_FIND_CONFIG_PHASE,
* 查找url对应的配置，如匹配location
NGX_HTTP_REWRITE_PHASE,
* 匹配到location后，可能会再次进入NGX_HTTP_SERVER_REWRITE_PHASE
NGX_HTTP_POST_REWRITE_PHASE,
* 检查url是否执行过阶段4，如果执行了，再次进入阶段3
* 最大检查次数为10，超过会报错
NGX_HTTP_PREACCESS_PHASE,
* 请求资源限速等操作
NGX_HTTP_ACCESS_PHASE,
* 访问控制，如限制ip访问
NGX_HTTP_POST_ACCESS_PHASE,
* 验证NGX_HTTP_ACCESS_PHASE（访问控制）结果，如果通过则继续
NGX_HTTP_PRECONTENT_PHASE,
* try_files指令时生效
NGX_HTTP_CONTENT_PHASE,
* 处理http请求内容，一般需要与后端应用进行交互
NGX_HTTP_LOG_PHASE
* 日志输出
ngx_lua 执行阶段
执行顺序
init_by_lua_block
init_worker_by_lua_block
set_by_lua_block
rewrite_by_lua_block
access_by_lua_block
content_by_lua_block
header_filter_by_lua_block
body_filter_by_lua_block
log_filter_by_lua_block
init_by_lua_block：nginx初始化、重启时执行，在http模块中设置
http {
include mime.types;
default_type application/octet-stream;
init_by_lua_block {
local uuid = require 'resty.jit-uuid';
uuid.seed();
}
...
}
init_by_lua_file：作用与init_by_lua_block相同，代码块保存在文件中
http {
include mime.types;
default_type application/octet-stream;
init_worker_by_lua_file /usr/local/nginx/conf/init.lua
...
}
# /usr/local/nginx/conf/init.lua 文件内容
local uuid = require 'resty.jit-uuid';
uuid.seed();
init_worker_by_lua_block：master进程启动后，执行相关代码块，在http模块中设置
# 可用来执行定时任务、后端健康检查
http {
include mime.types;
default_type application/octet-stream;
init_worker_by_lua_block {
...
}
...
}
set_by_lua_block：执行代码块，并将结果返回，在server、location语句块中设置
语法格式：set_by_lua_block $result {...}
* 该命令是阻塞命令，执行的语句块尽可能短、快，避免耗时过多
* 语句块中禁用：ngx.say()、ngx.exit()、ngx.sleep()等命令
server {
listen 80;
server_name localhost;
set $a "";
set_by_lua_block $a {
return "1";
}
location / {
root /usr/local/openresty/nginx/html;
index index.html index.htm;
}
...
}
rewrite_by_lua_block：重写阶段执行，可在http、server、location中设置
语法格式：rewrite_by_lua_block {...}
* 语句块会在最后执行，可通过rewrite_by_lua_no_postpone（默认off）改变执行顺序
* 可调用所有ngx api
# a的值为2
server {
listen 80;
server_name localhost;
set $a "1";
rewrite_by_lua_block {
ngx_var_a="2";
}
set $a "3"
location / {
root /usr/local/openresty/nginx/html;
index index.html index.htm;
}
...
}
# http阶段配置：rewrite_by_lua_no_postpone on
# a的值为3
server {
listen 80;
server_name localhost;
set $a "1";
rewrite_by_lua_block {
ngx_var_a="2";
}
set $a "3"
location / {
root /usr/local/openresty/nginx/html;
index index.html index.htm;
}
...
}
access_by_lua_block：access阶段执行语句块（权限检查、黑白名单），在http、server、location中设置
语法格式：access_by_lua_block {...}
* 语句块会在最后执行，可通过access_by_lua_no_postpone（默认off）改变执行顺序
* 可调用所有ngx api
* 应用：将黑白名单存放在redis、共享内存中，动态设置黑白名单
content_by_lua_block：内容处理阶段执行，设置输出内容，在location中设置
语法格式：content_by_lua_block {...}
* 可调用所有ngx api
* 若与其他内容执行阶段语句同时使用，content_by_lua_block可能不会执行
location / {
content_by_lua_block {
ngx.say("hello gtlx");
}
echo "test" #只会输出test，不会输出hello gtlx
}
content_by_lua_file：与content_by_lua_block相同，语句保存在文件中，在location中设置
语法格式：content_by_lua_file file
* 可调用所有ngx api
location / {
content_by_lua_file /usr/local/openresty/file/test.lua
}
# 文件：/usr/local/openresty/file/test.lua
hello gtlx
balancer_by_lua_block：内容处理阶段执行，在upstream语句中使用
语法格式：balancer_by_lua_block {...}
* upstream使用的ip为balancer_by_lua_block中设置的地址
* 禁用的api：cosockets、light threads
upstream web-server {
server 172.18.0.2 #会忽略server设置的ip地址
balancer_by_lua_block {
... #真是使用的ip地址
}
}
header_filter_by_lua_block：响应阶段添加、删除响应头，在http、server、location中设置
语法格式：header_filter_by_lua_block {...}
* 禁用的api：ngx.say()、ngx.redirect()、ngx.exec()等
# 添加响应头
location / {
header_filter_by_lua_block {
ngx.header.test="hello gtlx"
}
echo "hello"
}
body_filter_by_lua_block：响应阶段修改响应体，在http、server、location中设置
语法格式：body_filter_by_lua_block {...}
* 禁用的api：ngx.say()、ngx.redirect()、ngx.exec()等
# 将相应数据转换为大写(ngx.arg[1]获取响应数据，ngx.arg[2]响应结束符)
# 输出：HELLO
location / {
body_filter_by_lua_block {
ngx.arg[1] = string.upper(ngx.arg[1]);
}
echo "hello"
}
log_by_lua_block：输出日志，可在http、server、location中设置
语法格式：log_filter_by_lua_block {...}
* 在access_log之前执行，不会替换当前的access_log日志
* 禁用的api：ngx.say()、ngx.redirect()、ngx.exec()等
location / {
log_filter_by_lua_block {
ngx.log("hello gtlx")
}
echo "hello"
}