内嵌变量
ngx_http_core_module
模块支持内嵌变量,变量名与Apache服务器对应。 首先,这些变量可以表示客户端的请求头字段,诸如$http_user_agent
、$http_cookie
等等。 nginx也支持其他变量:
-
请求行中的
name
参数。 - 请求行中参数字符串。
- 客户端IP地址的二进制形式,值的长度总是4字节。
- nginx返回给客户端的字节数,不含响应头。
- nginx返回给客户端的字节数(1.3.8, 1.2.5)。
- 连接的序列号(1.3.8, 1.2.5)。
- “Content-Length”请求头的值。
- “Content-Type”请求头的值。
-
名为
name
的cookie。 - 当前请求的 root指令或 alias指令的配置值。
-
与
$uri
相同。 - “Host”请求头的值,如果没有该请求头,则为与请求对应的虚拟主机的首要主机名。
- 机器名称。
- 任意请求header的值;变量名的后半部为转化为小写并且用下划线替代横线后的请求头名称。
-
如果连接是SSL模块,返回“
on
”,否则返回空字符串。 -
如果请求行带有参数,返回“
?
”,否则返回空字符串。 - 允许设置此值来限制连接的传输速率。
- 当前时间,单位是秒,精度是毫秒。(1.3.9, 1.2.6)
- nginx版本号。
- worker进程的PID。
-
与
$args
相同。 - 按 root指令或 alias指令算出的当前请求的绝对路径。其中的符号链接都会解析成真是文件路径。
- 客户端IP地址。
- 客户端端口。
- 为基本用户认证提供的用户名。
- 完整的原始请求行。
-
请求正文。
在由proxy_pass指令和 fastcgi_pass指令处理的路径中, 这个变量值可用。
-
请求正文的临时文件名。
处理完成时,临时文件将被删除。 如果希望总是将请求正文写入文件,需要开启client_body_in_file_only。 如果在被代理的请求或FastCGI请求中传递临时文件名,就应该禁止传递请求正文本身。 使用proxy_pass_request_body off指令 和fastcgi_pass_request_body off指令 分别禁止在代理和FastCGI中传递请求正文。
-
请求完成时返回“
OK
”,否则返回空字符串。 - 基于 root指令或 alias指令,以及请求URI,得到的当前请求的文件路径。
-
HTTP方法,通常为“
GET
”或者“POST
”。 - 请求处理的时间,单位为秒,精度是毫秒(1.3.9, 1.2.6);请求处理时间从由客户端接收到第一个字节开始计算。
- 完整的原始请求行(带参数)。
-
请求协议类型,为“
http
”或“https
”。 - 任意的响应头字段的值。 变量名的后半部为转化为小写并且用下划线替代横线后的响应头名称。
-
接受请求的服务器地址。
为计算这个值,通常需要进行一次系统调用。为了避免系统调用,必须指定listen指令 的地址,并且使用
bind
参数。 - 接受请求的虚拟主机的首要主机名。
- 接受请求的虚拟主机的端口。
-
请求协议,通常为“
HTTP/1.0
”或“HTTP/1.1
”。 - 响应状态码。
-
客户端TCP连接的信息,在支持套接字选项
TCP_INFO
的系统中可用。 -
当前请求
规范化以后的URI。
变量
$uri
的值可能随请求的处理过程而改变。 比如,当进行内部跳转时,或者使用默认页文件。
$arg_
name
$args
$binary_remote_addr
$body_bytes_sent
$bytes_sent
$connection
$content_length
$content_type
$cookie_
name
$document_root
$document_uri
$host
$hostname
$http_
name
$https
$is_args
$limit_rate
$msec
$nginx_version
$pid
$query_string
$realpath_root
$remote_addr
$remote_port
$remote_user
$request
$request_body
$request_body_file
$request_completion
$request_filename
$request_method
$request_time
$request_uri
$scheme
$sent_http_
name
$server_addr
$server_name
$server_port
$server_protocol
$status
$tcpinfo_rtt
,
$tcpinfo_rttvar
,
$tcpinfo_snd_cwnd
,
$tcpinfo_rcv_space
$uri