案例一：Lua脚本获取URL中的参数

• 通过ngx_lua模块的内置方法ngx.req.get_uri_args()获取URL后面的请求参数
• 通过Nginx内置变量$arg_PARAMETER获取请求参数的值

#ngx.req.get_uri_args()方法Lua脚本获取URL中的参数
location /add_params_demo {
	set_by_lua	$sum	'
		local args = ngx.req.get_uri_args();
		local a = args["a"];
		local b = args["b"];
		return a + b;
	';
echo "$arg_a + $arg_b = $sum";
}

#ngx.arg获取请求参数值
location /add_params_demo_2 {
	set_by_lua	$sum	'
		local a = tonumber(ngx.arg[1]);
		local b = tonumber(ngx.arg[2]);
		return a + b;
	'	$arg_a $arg_b;
	echo "$arg_a + $arg_b = $sum";
}

Nginx Lua的内置方法

案例二：通过ngx.header设置HTTP响应头

ngx_lua模块可以通过内置变量ngx.header来访问和设置HTTP响应头字段，ngx.header的类型为table，可以通过ngx.header.HEADER形式应用某个响应头。

例如：使用ngx.header.set_cookie变量设置响应头set-cookie的值，使用table类型的对象可以一次设置多个set-cookie值。

#模拟上游服务
location /header_demo {
	content_by_lua_block {
  	ngx.header["header1"] = "value1";
    ngx.header.header2 = 2;
    ngx.header.set_cookie = {'Foo=bar; test=ok; path=/','age=18; path=/'};
    ngx.say("演示程序： ngx.header的使用");
  }
}

#模拟网关反向代理
location /header_filter_demo {
	proxy_pass http://127.0.0.1/header_demo;

  header_filter_by_lua_block {
  	local cookies = ngx.header.set_cookie;
  	if cookies then
      if type(cookies) == "table" then
      	local cookie = {}
    		for k, v in pairs(cookies) do
      		cookie[k]= v..";Secure;httponly"
      	end
      	ngx.header.set_cookie = cookie
      else
      	ngx.header.set_cookie = cookies..";Secure;httponly"
      end
    end
  }
}

响应结果如下

Cookie是通过请求的set-cookie响应头来保存的，HTTP响应内容中可以包含多个set-cookie响应头，一个set-cookie响应头的值通常为一个字符串。该字符串大致包含如下Cookie信息或属性

• Cookie名称：只能使用可以用于URL中的字符，一般为字母和数字，不能包含特殊字符，否则需要转码。
• Cookie值： 同Cookie名称。
• expires： Cookie过期日期。
• path： Cookie的访问路径。此属性设置指定路径下的页面才可以访问该Cookie。访问路径的值一般设为“/”。
• domain： Cookie的访问域名。此属性设置指定域名下的页面才可以访问该Cookie。
• Secure： Cookie的安全属性，此属性设置该Cookie是否只能通过HTTPS协议访问。只有值，没有名称。
• HttpOnly： 如果设置了该属性，那么通过程序将无法读取到Cookie信息。只有值，没有名称。

当设置了HttpOnly属性时，通过脚本将无法获取到Cookie信息，主要用于防止XSS攻击。

而一旦设置了Secure属性，前后端之间只能在HTTPS协议通信的情况下，浏览器才能访问Cookie，使用HTTP协议时，浏览器无法获取Cookie信息，同样是对Cookie信息的保护。通常都是在内网环境继续使用HTTP通信协议，然后通过Nginx网关完成外部HTTPS协议到内部HTTP协议的转换。此时，Nginx外部网关可以对Cookie属性进行修改，增加Secure安全属性。

案例三：Lua访问Nginx变量

无论是Nginx内部变量还是自定义变量，都可以在Lua代码中通过ngx.var进行访问。

#通过ngx.var访问Nginx变量
location /lua_var_demo {
  
	#自定义Nginx变量，名为hello，值为world
  set $hello world;

  content_by_lua_block {
  	local basic = require("conf.luaScript.module.common.basic");
    
    --定义一个Lua table，暂存需要输出的Nginx内置变量
    local vars = {};
    
    vars.remote_addr = ngx.var.remote_addr;
    vars.request_uri = ngx.var.request_uri;
    vars.query_string = ngx.var.query_string;
    vars.uri = ngx.var.uri;

    vars.nginx_version = ngx.var.nginx_version;
    vars.server_protocol = ngx.var.server_protocol;
    vars.request_method = ngx.var.request_method;
    vars.request_filename = ngx.var.request_filename;
    vars.document_root = ngx.var.document_root;
    vars.body_bytes_sent = ngx.var.body_bytes_sent;
    vars.binary_remote_addr = ngx.var.binary_remote_addr;
    vars.args = ngx.var.args;

    --通过内置变量访问请求参数
    vars.foo = ngx.var.arg_foo;
    ngx.say("演示程序： 将内置变量返回给客户端<br>");
    --使用自定义函数将Lua table转换成字符串，然后输出
    local str = basic.tableToStr(vars, ",<br>");
    ngx.say(str);

    ngx.say("<br>演示程序： 将普通变量返回给客户端<br>");
    --访问自定义Nginx变量hello
    local hello = ngx.var.hello;
    ngx.say("hello = "..hello);
  } 	
}

重启OpenResty后，浏览器访问http://localhost/lua_var_demo

案例四：Lua访问请求上下文变量

Nginx执行Lua脚本涉及很多阶段，每个阶段都可以嵌入不同的Lua脚本，不同阶段的Lua脚本可以通过ngx.ctx进行上下文变量共享。ngx.ctx上下文实质上是一个Lua table，其生存周期与当前请求相同，当前请求不同阶段嵌入的Lua脚本都可以读写ngx.ctx表中的属性。这些属性可以在请求处理的rewrite、access、content等各处理阶段进行共享。另外，在ngx_lua模块中，每个请求，包括子请求，都有一份独立的ngx.ctx表。

演示示例

#Lua访问请求上下文变量
location /ctx_demo {
	rewrite_by_lua_block {
  	-- 在上下文设置属性var1
   	ngx.ctx.var1 = 1;
  }

  access_by_lua_block {
  	-- 在上下文设置属性var2
    ngx.ctx.var2 = 10;
  }

  content_by_lua_block {
    local basic = require("conf.luaScript.module.common.basic");
   	-- 在上下文设置属性var3
    ngx.ctx.var3 = 100;

    -- 3个上下文求和
    local result = ngx.ctx.var1 + ngx.ctx.var2 + ngx.ctx.var3;
    ngx.say(result);

    ngx.ctx.sum = result;

    -- 使用自定义函数将Lua table转换成字符串
    local str = basic.tableToStr(ngx.ctx, ",<br>");
    ngx.say("<br>");
    ngx.say(str);
  }
}

运行结果：

下一篇介绍复杂案例！