nginx教程第七篇：ngx_http_core_module模块提供的变量

我就是我 2022-05-10 00:18 123阅读 0赞

在记录access\_log访问日志文件时， 可以使用ngx\_http\_core\_module模块处理请求时所产  
生的丰富的变量， 当然， 这些变量还可以用于其他HTTP模块。

例如：
    	当URI中的某个参数满足设定的条件时， 有些HTTP模块的配置项可以使用类似 $arg_PARAMETER 这样的变量。
    又如：
    	若想把每个请求中的限速信息记录到access日志文件中， 则可以使用 $limit_rate 变量。

下表列出了ngx\_http\_core\_module模块提供的这些变量：

<table> 
 <thead> 
  <tr> 
   <th>变量</th> 
   <th align="center">变量描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>$arg_patameter</td> 
   <td align="center">HTTP请求中某个参数的值，如/index.php?<a href="http://site=www.ttlsa.com" rel="nofollow">site=www.ttlsa.com</a>，可以用$arg_site取得www.ttlsa.com这个值</td> 
  </tr> 
  <tr> 
   <td>$args HTTP</td> 
   <td align="center">请求中的完整参数</td> 
  </tr> 
  <tr> 
   <td>$binary_remote_addr</td> 
   <td align="center">二进制客户端地址</td> 
  </tr> 
  <tr> 
   <td>$body_bytes_sent</td> 
   <td align="center">表示在想客户端发送的http响应中，包体部分的字节数</td> 
  </tr> 
  <tr> 
   <td>$content_length</td> 
   <td align="center">表示客户端请求头部中Conten-Length字段</td> 
  </tr> 
  <tr> 
   <td>$conten_type</td> 
   <td align="center">表示客户端请求头部中Conten-Type字段</td> 
  </tr> 
  <tr> 
   <td>$cookie_COOKIE</td> 
   <td align="center">表示客户端请求头部中cookie字段</td> 
  </tr> 
  <tr> 
   <td>$document_root</td> 
   <td align="center">表示当前请求所使用的root配置项的值</td> 
  </tr> 
  <tr> 
   <td>$uri</td> 
   <td align="center">表示当前请求的URI，不带任何参数</td> 
  </tr> 
  <tr> 
   <td>$document_uri</td> 
   <td align="center">与$uri相同</td> 
  </tr> 
  <tr> 
   <td>$request_uri</td> 
   <td align="center">表示客户端发来的原始请求URI，带完整的参数</td> 
  </tr> 
  <tr> 
   <td>$host</td> 
   <td align="center">表示客户端请求头部中的Host字段，如果Host字段不存在，则以实际处理的server名称代替，如果Host字段中带有端口，如IP:PORT，那么$host是去掉端口的，它的值是IP，$host是全小写</td> 
  </tr> 
  <tr> 
   <td>$hostname</td> 
   <td align="center">表示Nginx所在机器的名称</td> 
  </tr> 
  <tr> 
   <td>$http_HREADER</td> 
   <td align="center">表示当前HTTP请求中相应头部的值</td> 
  </tr> 
  <tr> 
   <td>$sent_http_HERDER</td> 
   <td align="center">表示返回客户端的HTTP响应中相应头部的值</td> 
  </tr> 
  <tr> 
   <td>$is_args</td> 
   <td align="center">表示请求中的URI是否携带参数，如果携带值为？，如果没有为空字符串</td> 
  </tr> 
  <tr> 
   <td>$limit_rate</td> 
   <td align="center">表示当前连接的限速是多少，0表示无限速</td> 
  </tr> 
  <tr> 
   <td>$nginx_version</td> 
   <td align="center">表示当前Nginx的版本号</td> 
  </tr> 
  <tr> 
   <td>$query_string</td> 
   <td align="center">请求URI中的参数，与$args相同</td> 
  </tr> 
  <tr> 
   <td>$remote_addr</td> 
   <td align="center">表示客户端的地址</td> 
  </tr> 
  <tr> 
   <td>$remote_port</td> 
   <td align="center">表示客户端连接使用的端口</td> 
  </tr> 
  <tr> 
   <td>$remote_user</td> 
   <td align="center">表示使用Auth Basic Module时定义的用户名</td> 
  </tr> 
  <tr> 
   <td>$request_filename</td> 
   <td align="center">表示用户请求中的URI经过root或alias转换后的文件路径</td> 
  </tr> 
  <tr> 
   <td>$request_body</td> 
   <td align="center">表示HTTP请求中的包体，改参数只在proxy_pass或fastcgi_pass中有意义</td> 
  </tr> 
  <tr> 
   <td>$request_completion</td> 
   <td align="center">当请求全部完成时，其值为ok，如果没有完成，返回客户端，其值为空字符串</td> 
  </tr> 
  <tr> 
   <td>$request_method</td> 
   <td align="center">表示HTTP请求中的方法名，GET、PUT、POST等</td> 
  </tr> 
  <tr> 
   <td>$scheme</td> 
   <td align="center">表示HTTP scheme，如在请求https://nginx.com中表示https</td> 
  </tr> 
  <tr> 
   <td>$server_addr</td> 
   <td align="center">表示服务器地址</td> 
  </tr> 
  <tr> 
   <td>$server_name</td> 
   <td align="center">表示服务器名称</td> 
  </tr> 
  <tr> 
   <td>$server_port</td> 
   <td align="center">表示服务器端口</td> 
  </tr> 
  <tr> 
   <td>$server_protocol</td> 
   <td align="center">表示服务器向客户端发送响应的协议</td> 
  </tr> 
 </tbody> 
</table>