Nginx内置变量

内置变量

Nginx内置变量

变量名	内容
A	A
``
$args	请求中的参数值
$arg_name	GET请求中 name 的值，即"?"后面的 arg_name=arg_value 形式的 arg_name
``
B	B
``
$binary_remote_addr	客户端地址的二进制形式，固定长度为4个字节
$body_bytes_sent	传输给客户端的字节数，响应头不计算在内；这个变量和 Apache 的 mod_log_config 模块中的 %B 参数保持兼容。
$bytes_sent	传输给客户端的字节数
``
C	C
``
$connection	TCP 连接的序列号
$connection_requests	TCP 连接当前的请求数量
$content_length	"Content-Length" 请求头字段
$content_type	"Content-Type" 请求头字段
$cookie_name	cookie 名称
$cookie_NAME	客户端请求Header头中的cookie变量，前缀“$cookie”名称的变量，该变量的值即为cookie名称的值
``
D	D
``
$document_root	当前请求的文档根目录或别名
$document_uri	同 $uri
``
E	E
``
F	F
``
G	G
``
H	H
``
$host	优先级：HTTP请求行的主机名 > "HOST" 请求头字段 > 符合请求的服务器名
$hostname	主机名
$https	如果开启了 SSL 安全模式，值为 on，否则为空字符串。
$http_cookie
$http_name	匹配任意请求头字段；变量名中的后半部分NAME可以替换成任意请求你头字段 如在配置文件中需要获取HTTP请求头：“Accept-Language”，$http_accept_language即可
$http_post
$http_referer	url 跳转来源，用来记录从哪个页面链接访问过来的
$http_user_agent	用户终端的浏览器等信息
$http_x_forwarded_for
I	I
``
$is_args	如果请求中有参数，值为 "?" ，否则为空字符串
``
J	J
``
K	K
``
L	L
$limit_rate	用于设置响应的速度限制
M	M
$msec	当前的 Unix 时间戳
N	N
$nginx_version	Nginx 版本
O	O
``
P	P
$pid	工作进程的PID
$pide	如果请求来自管道通信，值为 p ，否则为 .
$proxy_protocol_addr	获取代理访问服务器的客户端地址，如果是直接访问，该值为空字符串
Q	Q
``
$query_string	请求中的参数值
``
R	R
$realpath_root	当前请求的文旦根目录或别名的真实路径，会将所有符号连接转换为真实路径
$remote_addr	客户端地址
$remote_port	客户端端口
$remote_user	用于 HTTP 基础认证服务的用户名
$request	代表客户端的请求地址
$request_body	客户端的请求主体：此变量可在 location 中使用，将请求主体通过 proxy_pass ，fastcgi_pass ，uwsgi_pass 和 scgi_pass 传递给下一级的代理服务器
$request_body_file	将客户端请求主体保存在临时文件中。 文件处理结束后，此文件需删除。 如果需要之一开启此功能，需要设置 client_body_in_file_only 。 如果将次文件传递给后端的代理服务器，需要禁止 request body，即设置 proxy_pass_request_body off ，fastcgi_pass_request_body off，fastcgi_pass_request_body off，uwsgi_pass_request_body off，or scgi_pass_request_body off
$request_completion	如果请求成功，值为 “OK” ，如果请求未完成或者请求不是一个范围请求的最后一部分，则为空
$request_filename	当前链接请求的文件路径，由 root 或 alias 指令与 URL 请求生成
$request_length	请求的长度（包括请求的地址，HTTP请求头和请求主体）
$request_method	HTTP 请求方法，通常为 “GET” 或 “POST”
$request_time	处理客户端请求使用的时间；从读取客户端的第一个字节开始计时
$request_uri	这个变量等于包含一些客户端请求参数的原理URI，它无法修改，请查看 $uri 更改或重写 URI，不包含主机名，例如：“/cnphp/test.php?arg=freemouse”
S	S
$scheme	请求使用的 Web 协议，“HTTP” 或 “HTTPS”
$sent_http_cache_control
$sent_http_connection
$sent_http_content_type
$sent_http_keep_alive
$sent_http_last_modified
$sent_http_location
$sent_http_transfer_encoding
$sent_http_NAME	可以设置任意HTTP响应头字段；变量名中的后半部分NAME可以替换成任意响应字段 如需要设置响应头 Content-length，$sent_http_content_length即可
$server_addr	服务器地址，需要注意的是：为了避免访问Linux系统内核，应将IP地址提前设置在配置文件中
$server_name	服务器名
$server_port	服务器端口
$server_protocol	服务器的HTTP版本，通常为 “HTTP/1.0” 或 “HTTP/1.1”
$status	HTTP响应代码
T	T
$time_iso8601	服务器时间的ISO 8601格式
$time_local	服务器时间（LOG Format 格式）
U	U
``
$uri	请求中的当前 URL（不带请求参数，参数位于 $args），可以不同于浏览器传递的 $request_uri 的值，它可以通过重定向，或者使用 index 指令进行修改， $uri 不包括主机名。 如 /foo/bar,html
``
V	V
``
W	W
``
X	X
``
Y	Y
``
Z	Z
``
``
``