nginx内置预定义变量

title: nginx内置变量 #标题tags: nginx #标签
date: 2020-03-28
categories: nginx # 分类

本博文用于记录nginx中内置的一些预定义变量。
upstream_response_time相比，)

# nginx的配置文件中可以使用的内置变量以美元符$开始，也有人叫全局变量。其中，部分预定义的变量的值是可以改变的。
$request_time: 表示从接受用户请求的第一个字节到发送完整响应数据的时间，即包括接收请求数据时间、程序响应时间、输出响应数据时间。
$upstream_response_time: 表示从nginx向后端（upstream定义的主机列表）建立连接开始到接受完数据，然后关闭连接为止的时间。
$http_referer: 客户请求的完整url，如: https://rdcmdi.i139.cn/index.php?m=project&f=task&project=12&Type=all
$http_host: 客户端请求的IP+端口。
$scheme：所用的协议，比如http或者是https，比如rewrite ^(.+)$ $scheme://example.com$1 redirect;
$host：请求中的主机头(Host)字段，如果请求中的主机头不可用或者空，则为处理请求的server名称(处理请求的server的server_name指令的值)。值为小写，不包含端口。
$arg_PARAMETER：这个变量值为：GET请求中变量名PARAMETER参数的值。
$gzip_ratio: 如果开启了gzip压缩，此变量可以记录下压缩率。
$args：这个变量等于GET请求中的参数。例如，foo=123&bar=blahblah;这个变量只可以被修改
$binary_remote_addr：二进制码形式的客户端地址。
$body_bytes_sent：传送页面的字节数
$content_length：请求头中的Content-length字段。
$content_type：请求头中的Content-Type字段。
$cookie_COOKIE：COOKIE的值。
$document_root：当前请求在root指令中指定的值。
$document_uri：与$uri相同。
$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指令的location中比较有意义。
$request_body_file：客户端请求主体信息的临时文件名。
$request_completion：如果请求成功，设为"OK"；如果请求未完成或者不是一系列请求中最后一部分则设为空。
$request_method： 这个变量是客户端请求的动作，通常为GET或POST。
包括0.8.20及之前的版本中，这个变量总为main request中的动作，如果当前请求是一个子请求，并不使用这个当前请求的动作。
$request_uri： 这个变量等于包含一些客户端请求参数的原始URI，它无法修改，请查看$uri更改或重写URI。
$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