OpenResty 002openResty内置变量

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

ngx.var.uri          : /liveroom
ngx.var.request      : GET /liveroom?d=10&b=20 HTTP/1.1
ngx.var.time_local   : 30/Nov/2016:17:23:45 +0800
ngx.var.time_iso8601 : 2016-11-30T17:25:37+08:00
ngx.var.remote_addr  : 10.10.40.120
ngx.var.status       : 200
ngx.var.body_bytes_sent : 0
ngx.var.bytes_sent      : 216
ngx.var.request_length  : 200
ngx.var.request_time    : 0.000s
ngx.var.upstream_addr   : nil,
ngx.var.upstream_response_time  : nil,
ngx.var.remote_user             : nil,
ngx.var.http_accept_language    : nil,
ngx.var.http_user_agent         : curl/7.19.7 (x86_64-redhat-linux-gnu) ...
ngx.var.http_host               : baidu.com
ngx.var.http_referer            : nil,
ngx.var.http_cookie             : 获取所有cookie，这里获取到的是一个字符串，如果不存在则返回nil
ngx.var.cookie_username         : 获取单个cookie，_后面的cookie的name，如果不存在则返回nil
ngx.var.connection              : 118,
ngx.var.connection_requests     : 1,
ngx.var.msec                    : 1480499093.377
ngx.var.pipe                    : . 
ngx.var.request_filename        : /usr/local/ngx_openresty_proxy/nginx/html/xyroom/ddm,
ngx.var.server_protocol         : HTTP/1.1
ngx.var.arg_xxx                 : 获取GET参数xxx的值
ngx.req.get_headers(）          : 获取请求头信息

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

日志变量            解释                                                  实例日志内容
$time_local       通用日志格式下的本地时间；（服务器时间）         ==> 20/Mar/2014:17:36:21 +0900
$remote_addr      客户端（用户）IP地址。                        ==> 118.000.72.00
$status           请求状态（状态码，200表示成功，404表示页面不存在，301表示永久重定向等；==> 304
$body_bytes_sent  发送给客户端的字节数，不包括响应头的大小； 该变量与Apache模块mod_log_config里的“%B”参数兼容；==> 0
$bytes_sent       发送给客户端的总字节数；                 ==> 204
$request_length   请求的长度（包括请求行，请求头和请求正文）；==> 609
$request_time     请求处理时间，单位为秒，精度毫秒； 从读入客户端的第一个字节开始，直到把最后一个字符发送给客户端后进行日志写入为止；==> 0.001
$upstream_addr    集群轮询地址；                                                             ==> 192.168.18.72:9080
$upstream_response_time   是指从Nginx向后端（php-cgi)建立连接开始到接受完数据然后关闭连接为止的时间；==> 0.001
$remote_user     用来记录客户端用户名称；    ==> 空值 -
$request         请求方式（GET或者POST等）；==> GET /ja/xxx.js HTTP/1.1
$http_accept_language    用户浏览器语言；  ==> zh-CN,zh;q=0.8,en;q=0.6
$http_user_agent用户浏览器其他信息，浏览器版本、浏览器类型等；==> Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/33.0.1750.146 Safari/537.36
$http_host      请求的url地址（目标url地址）的host； ==> tzjs.ptmind.com
$http_referer   来源页面，即从哪个页面转到本页，专业名称叫做“referer”；==> 直接访问值为空
$connection     接的序列号；==> 8614960
$connection_requests   当前通过一个连接获得的请求数量； ==> 1
$time_iso8601ISO8601   标准格式下的本地时间；         ==> 2014-03-20T17:36:21+09:00
$msec           日志写入时间。单位为秒，精度是毫秒；     ==> 1395304581.680
$pipe           如果请求是通过HTTP流水线(pipelined)发送，pipe值为“p”，否则为“.”；==> .
$uri            请求中的当前URI(不带请求参数，参数位于$args)，不同于浏览器传递的$request_uri的值，它可以通过内部重定向，或者使用index指令进行修改。不包括协议和主机名，例如/foo/bar.html==> /ja/xxx.js
$request_filename          当前连接请求的文件路径，由root或alias指令与URI请求生成。==> /usr/local//nginx/html/ja/xxx.js
$server_protocol|$scheme   请求使用的协议，通常是HTTP/1.0或HTTP/1.1。==> http
$geoip_country_code        用户地理位置代码（国家代码）安装国家地理代码库可用；

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

$arg_PARAMETER      这个变量值为：GET请求中变量名PARAMETER参数的值。
$args               这个变量等于GET请求中的参数。例如，foo=123&bar=blahblah;这个变量只可以被修改
$binary_remote_addr 二进制码形式的客户端地址。
$body_bytes_sehnt   传送页面的字节数
$content_length     请求头中的Content-length字段。
$content_type       请求头中的Content-Type字段。
$cookie_COOKIE      cookie COOKIE的值。
$document_root      当前请求在root指令中指定的值。
$document_uri       与$uri相同。
$host               请求中的主机头(Host)字段，如果请求中的主机头不可用或者空，则为处理请求的server名称(处理请求的server的server_name指令的值)。值为小写，不包含端口。
$hostname           机器名使用 gethostname系统调用的值
$http_HEADER        HTTP请求头中的内容，HEADER为HTTP请求中的内容转为小写，-变为_(破折号变为下划线)，例如：$http_user_agent(Uaer-Agent的值), $http_referer...;
$sent_http_HEADER   HTTP响应头中的内容，HEADER为HTTP响应中的内容转为小写，-变为_(破折号变为下划线)，例如： $sent_http_cache_control, $sent_http_content_type...;
$is_args            如果$args设置，值为"?"，否则为""。
$limit_rate         这个变量可以限制连接速率。
$nginx_version      当前运行的nginx版本号。
$query_string       与$args相同。
$remote_addr        客户端的IP地址。
$remote_port        客户端的端口。
$remote_user        已经经过Auth Basic Module验证的用户名。
$request_filename   当前连接请求的文件路径，由root或alias指令与URI请求生成。
$request_body       这个变量（0.7.58+）包含请求的主要信息。在使用proxy_pass或fastcgi_pass指令st的location中比较有意义。
$request_body_file  客户端请求主体信息的临时文件名。
$request_completion 如果请求成功，设为"OK"；如果请求未完成或者不是一系列请求中最后一部分则设为空。
$request_method     这个变量是客户端请求的动作，通常为GET或POST。
                    包括0.8.20及之前的版本中，这个变量总为main request中的动作，如果当前请求是一个子请求，并不使用这个当前请求的动作。
$request_uri        这个变量等于包含一些客户端请求参数的原始URI，它无法修改，请查看$uri更改或重写URI。
$scheme             所用的协议，比如http或者是https，比如rewrite ^(.+)$ $scheme://example.com$1 redirect;
$server_addr        服务器地址，在完成一次系统调用后可以确定这个值，如果要绕开系统调用，则必须在listen中指定地址并且使用bind参数。
$server_name        服务器名称。
$server_port        请求到达服务器的端口号。
$server_protocol    请求使用的协议，通常是HTTP/1.0或HTTP/1.1。
$uri                请求中的当前URI(不带请求参数，参数位于$args)，不同于浏览器传递的$request_uri的值，它可以通过内部重定向，或者使用index指令进行修改。不包括协议和主机名，例如/foo/bar.html
$http_host          请求域名