前言:上一篇写到Nginx核心模块HTTP模块,这一篇主要讲ngx_http_core_module模块提供的变量

在记录access_log访问日志文件时,可以使用ngx_http_core_module模块处理请求时所产生的丰富的变量,当然这些变量还可以用户其他HTTP模块。例如:当URI中的某个参数满足设定的条件时,有些HTTP模块的配置项可以使用类似$arg_PARAMETER这样的变量。又如,若想把每个请求中的限速信息记录到access日志文件中,则可以使用$limit_rate变量。

参数名

意义

$arg_PARAMETER

HTTP请求中某个参数的值,如/index.html?size=10,可以用&arg_size取得10这个值

$args

HTTP请求中的完整参数。例如:在请求/index.html?a=110&b=120中,$args表示字符串a=110&b=120

$binary_remote_addr

二进制格式的客户端地址。例如:\x0A\xE0B

$body_bytes_sent

表示在向客户端发送的http响应中,包体部分的字节数

$content_length

表示客户端请求头部中的Content-length字段

$content_type

表示客户端请求头部中国年的Content-Type字段

$cookie_COOKIE

表示在客户端请求头部中的cookie字段

$document_root

表示当前请求所使用的root配置项的值

$uri

表示当前请求的URI,不带任何参数。例如:/index.html

$request_uri

表示客户端发送来的原始请求URI,带完整参数。$uri和$document_root未必是用户的原始请求,在内部重定向后可能是重定向后的URI,而$request_uri永远不会改变,始终是客户端的原始URI

$host

表示客户端请求头部中的Host字段。如果Host字段不存在则以实际处理的server(虚拟主机)名称代替。如果Host字段中带有端口,如127.0.0.1:8080,那么$host是去掉端口的,它的值为IP。$host是全小写的。这些特性与http_HEADER中的http_host不同,http_host只是完全取出Host头部对应的值

$hostname

表示Nginx所在机器的名称,与gethostbyname调用返回的值相同

$http_HEADER

表示当前HTTP请求中相应头部的值。HEADER名称全小写,例如:用$htto_host表示请求中的Http头部对应的值

$send_http_HEADER

表示返回客户端的HTTP响应中头部的值。HEADER名称全小写。例如:用$send_http_content_type表示响应中Content_Type头部对应的值

$is_args

表示请求中的URI是否带参数,如果带参数,$is_args值为?,如果不带参数,则是空字符串

$limit_rate

表示当前连接的限速是多少,0表示不限速

$nginx_version

表示当前Nginx的版本号

$query_string

请求URI中的参数,与$args相同,然而$query_string是只读的不会改变

$remote_addr

表示客户端的ip地址

$remote_port

表示客户端连接使用的端口

$remote_user

表示使用Auth Basic Module 时定义的用户名

$request_filename

表示用户请求中的URI经过root或alias转换后的文件路径

$request_body

表示HTTP请求中的包体,该参数只在proxy_pass或fastcgi_pass中有意义

$request_body_file

表示HTTP请求中的包体存储的临时文件名

$request_completion

当请求已经全部完成时,其值为”ok”。若没有完成,就要返回客户端,则其值为空字符串;或者在断点续传等情况下使用HTTP range访问的并不是文件的最后一块,那么其值也是空字符串

$request_method

表示HTTP请求的方法名,如:GET,POST等

$scheme

表示HTTP scheme,如在请求https://www.baidu.com/中表示https

$server_addr

表示服务器地址

$server_name

表示服务器名称

$server_post

表示服务器端口

$server_protocol

表示服务器向客户端发送响应的协议,如:HTTP/1.1或HTTP/1.0