关于nginx的内置变量

关于nginx的内置变量

在OpenResty中，经常遇到nginx的内置变量，当时记住了，过一段时间在看到又感觉陌生无比。或者想不起来，或者自己也不确定，我在网上找了找然后在测试了一下，方便以后直观的查看。

nginx支持一些内建变量，与Apache使用的变量相一致，一些变量代表了 客户端请求头部的一些字段。入$http_user_agent $http_cookie等等，由于这些变量会在请求中定义，所以无法保证他们是否存在或者可以定义一些别的地方。
除此之外，下面是一些其他的变量，代码中使用
ngx.say(ngx.var.arg_name) ngx.exit(200),来测试结果。url是http://wuyachao.com/middleware/admin/getname?v=1&id=1111&name=aaa&sex

• $arg_PARAMETER
  例子：1. ngx.say(ngx.var.arg_name)
-- aaa
2. args = ngx.req.get_uri_args()
ngx.say(args.name) --这种方式是返回一个lua的表，然后从表中获取数据
-- aaa

• $uri

  请求中的当前URI(不带请求参数，参数位于$args)，可以不同于浏览器传递的$request_uri的值，它
  可以通过内部重定向，或者使用index指令进行修改。
  – /middleware/admin/getname

• $query_string

  与$args相同。
  – v=1&id=1111&name=aaa&sex

• $request_uri

  这个变量等于包含一些客户端请求参数的原始URI，它无法修改，请查看$uri更改或重写URI。
  – /middleware/admin/getname?v=1&id=1111&name=aaa&sex

• $binary_remote_addr

  二进制码形式的客户端地址。
  返回的是乱码

• $body_bytes_sent

  传送页面的字节数
  –返回值是：0

• $content_length

  请求头中的Content-length字段。
  –返回nil

• $content_type

  请求头中的Content-Type字段

• $cookie_COOKIE

  cookie COOKIE的值。

• $document_root

  当前请求在root指令中指定的值。
  – /data/sysadmin/xxxx/xxxxx/api.xxxx.com

• $document_uri

  与$uri相同。
  –/middleware/admin/getname

• $host

  请求中的主机头字段，如果请求中的主机头不可用，则为服务器处理请求的服务器名称。
  –midtest.api.xxxx.com

• $is_args

  如果$args设置，值为”?”，否则为”“。
  – ？

• $limit_rate

  这个变量可以限制连接速率。
  – 0

• $nginx_version

  当前运行的nginx版本号
  – 1.8.0 和 /usr/local/openresty/nginx/sbin/nginx -V 的一致

• $remote_addr

  客户端的IP地址
  – 172.xx.xx.xx 请求客户端的ip地址

• $remote_port

  客户端的端口。
  –61129

• $remote_user

  已经经过Auth Basic Module验证的用户名
  –nil， 没有被认证

• $request_filename

  当前连接请求的文件路径，由root或alias指令与URI请求生成。
  – /data/sysadmin/service_deploy_data/c2-hd-webplat/api.xxxx.com/middleware/admin/getname
  目录实际的目录/data/sysadmin/service_deploy_data/c2-hd-webplat/api.xxxx.com/application/action/api/middleware/admin/getname位置

• $request_body

  这个变量（0.7.58+）包含请求的主要信息。在使用proxy_pass或fastcgi_pass指令的location中比较有
  意义。
  – nil

• $request_body_file

  客户端请求主体信息的临时文件名。
  –nil

• $request_completion

  未知。 – 什么都没有返回

• $request_method

  这个变量是客户端请求的动作，通常为GET或POST。
  包括0.8.20及之前的版本中，这个变量总为main request中的动作，如果当前请求是一个子请求，并
  不使用这个当前请求的动作。
  – GET
  curl -d “name =wuyachao” http://wuyachao.com/middleware/admin/getname?v=1
  – 返回 POST

• $scheme

  HTTP方法（如http，https）。按需使用，例：
  rewrite ^(.+) <script type="math/tex" id="MathJax-Element-26"> </script>scheme://example.com$1 redirect;
  – http

• $server_addr

  服务器地址，在完成一次系统调用后可以确定这个值，如果要绕开系统调用，则必须在listen中指
  定地址并且使用bind参数
  – 192.168.19.xxx 对应的请求的服务器ip地址

• $server_name

  服务器名称。
  – midtest.api.xxxx.com 服务器的名称和上面的host

• $server_port

  请求到达服务器的端口号。
  – 80

• $server_protocol

  请求使用的协议，通常是HTTP/1.0或HTTP/1.1。
  –HTTP/1.1

• $HTTP_X_FORWARDED_FOR

  是透过代理服务器取得客户端的真实IP地址，有些用此方法读取到的仍然是代理服务器的IP。还有一点需要注意的是：如果客户端没有通过代理服务器来访问，那么用 HTTP_X_FORWARDED_FOR 取到的值将是空的
  – nil