Nginx配置详情-配置说明-参数优化-ngx_http_core_module模块变量（三）

最新推荐文章于 2024-06-25 19:50:42 发布

转载最新推荐文章于 2024-06-25 19:50:42 发布 · 121 阅读

文章标签：

#nginx

本文详细介绍了Nginx中ngx_http_core_module模块提供的各种变量及其用途，包括如何使用这些变量来记录日志、进行条件判断等操作。

原文地址为： Nginx配置详情-配置说明-参数优化-ngx_http_core_module模块变量（三）

前言：上一篇写到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