Nginx 之十一内置变量

Myth丶恋晨 2022-05-03 16:56 270阅读 0赞

nginx的配置文件中可以使用的内置变量以美元符$开始，也有人叫全局变量。其中，部分预定义的变量的值是可以改变的。

<table> 
 <thead> 
  <tr> 
   <th>变量</th> 
   <th align="left">说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>$arg_PARAMETER</td> 
   <td align="left">这个变量值为：GET请求中变量名PARAMETER参数的值。</td> 
  </tr> 
  <tr> 
   <td>$args</td> 
   <td align="left">这个变量等于GET请求中的参数。例如，foo=123&amp;bar=blahblah;这个变量只可以被修改</td> 
  </tr> 
  <tr> 
   <td>$binary_remote_addr</td> 
   <td align="left">二进制码形式的客户端地址。</td> 
  </tr> 
  <tr> 
   <td>$body_bytes_sent</td> 
   <td align="left">传送页面的字节数</td> 
  </tr> 
  <tr> 
   <td>$content_length</td> 
   <td align="left">请求头中的Content-length字段。</td> 
  </tr> 
  <tr> 
   <td>$content_type</td> 
   <td align="left">请求头中的Content-Type字段。</td> 
  </tr> 
  <tr> 
   <td>$cookie_COOKIE</td> 
   <td align="left">cookie COOKIE的值。</td> 
  </tr> 
  <tr> 
   <td>$document_root</td> 
   <td align="left">当前请求在root指令中指定的值。</td> 
  </tr> 
  <tr> 
   <td>$document_uri</td> 
   <td align="left">与$uri相同。</td> 
  </tr> 
  <tr> 
   <td>$host</td> 
   <td align="left">请求中的主机头(Host)字段，如果请求中的主机头不可用或者空，则为处理请求的server名称(处理请求的server的server_name指令的值)。值为小写，不包含端口。</td> 
  </tr> 
  <tr> 
   <td>$hostname</td> 
   <td align="left">机器名使用 gethostname系统调用的值</td> 
  </tr> 
  <tr> 
   <td>$http_HEADER</td> 
   <td align="left">HTTP请求头中的内容，HEADER为HTTP请求中的内容转为小写，-变为_(破折号变为下划线)，例如：$http_user_agent(Uaer-Agent的值), $http_referer…;</td> 
  </tr> 
  <tr> 
   <td>$sent_http_HEADER</td> 
   <td align="left">HTTP响应头中的内容，HEADER为HTTP响应中的内容转为小写，-变为_(破折号变为下划线)，例如： $sent_http_cache_control,$sent_http_content_type…;</td> 
  </tr> 
  <tr> 
   <td>$http_host</td> 
   <td align="left">和$host相同，如果请求信息中没有Host行，则可能不同</td> 
  </tr> 
  <tr> 
   <td>$http_cookie</td> 
   <td align="left">客户端的cookies</td> 
  </tr> 
  <tr> 
   <td>$http_referer</td> 
   <td align="left">引用地址</td> 
  </tr> 
  <tr> 
   <td>$http_user_agent</td> 
   <td align="left">客户端代理的信息</td> 
  </tr> 
  <tr> 
   <td>$http_via</td> 
   <td align="left">最后一个访问服务器的IP地址</td> 
  </tr> 
  <tr> 
   <td>$http_x_forwarded_for</td> 
   <td align="left">相当于网路访问路径</td> 
  </tr> 
  <tr> 
   <td>$is_args</td> 
   <td align="left">如果$args设置，值为"?"，否则为""。</td> 
  </tr> 
  <tr> 
   <td>$limit_rate</td> 
   <td align="left">这个变量可以限制连接速率。</td> 
  </tr> 
  <tr> 
   <td>$nginx_version</td> 
   <td align="left">当前运行的nginx版本号。</td> 
  </tr> 
  <tr> 
   <td>$pid</td> 
   <td align="left">当前Nginx服务器主进程的进程ID</td> 
  </tr> 
  <tr> 
   <td>$query_string</td> 
   <td align="left">与$args相同。</td> 
  </tr> 
  <tr> 
   <td>$remote_addr</td> 
   <td align="left">客户端的IP地址。</td> 
  </tr> 
  <tr> 
   <td>$remote_port</td> 
   <td align="left">客户端的端口。</td> 
  </tr> 
  <tr> 
   <td>$remote_user</td> 
   <td align="left">已经经过Auth Basic Module验证的用户名。</td> 
  </tr> 
  <tr> 
   <td>$request</td> 
   <td align="left">客户端请求</td> 
  </tr> 
  <tr> 
   <td>$request_filename</td> 
   <td align="left">当前连接请求的文件路径，由root或alias指令与URI请求生成。</td> 
  </tr> 
  <tr> 
   <td>$request_body</td> 
   <td align="left">这个变量（0.7.58+）包含请求的主要信息。在使用proxy_pass或fastcgi_pass指令的location中比较有意义。</td> 
  </tr> 
  <tr> 
   <td>$request_body_file</td> 
   <td align="left">客户端请求主体信息的临时文件名。</td> 
  </tr> 
  <tr> 
   <td>$request_completion</td> 
   <td align="left">如果请求成功，设为"OK"；如果请求未完成或者不是一系列请求中最后一部分则设为空。</td> 
  </tr> 
  <tr> 
   <td>$request_method</td> 
   <td align="left">这个变量是客户端请求的动作，通常为GET或POST包括0.8.20及之前的版本中，这个变量总为main request中的动作，如果当前请求是一个子请求，并不使用这个当前请求的动作。</td> 
  </tr> 
  <tr> 
   <td>$request_uri</td> 
   <td align="left">这个变量等于包含一些客户端请求参数的原始URI，它无法修改，请查看$uri更改或重写URI。</td> 
  </tr> 
  <tr> 
   <td>$scheme</td> 
   <td align="left">所用的协议，比如http或者是https，比如rewrite ^(.+)$ $scheme://example.com$1 redirect;</td> 
  </tr> 
  <tr> 
   <td>$server_addr</td> 
   <td align="left">服务器地址，在完成一次系统调用后可以确定这个值，如果要绕开系统调用，则必须在listen中指定地址并且使用bind参数。</td> 
  </tr> 
  <tr> 
   <td>$server_name</td> 
   <td align="left">服务器名称。</td> 
  </tr> 
  <tr> 
   <td>$server_port</td> 
   <td align="left">请求到达服务器的端口号。</td> 
  </tr> 
  <tr> 
   <td>$server_protocol</td> 
   <td align="left">请求使用的协议，通常是HTTP/1.0或HTTP/1.1。</td> 
  </tr> 
  <tr> 
   <td>$uri</td> 
   <td align="left">请求中的当前URI(不带请求参数，参数位于$args)，不同于浏览器传递的$request_uri的值，它可以通过内部重定向，或者使用index指令进行修改。不包括协议和主机名，例如/foo/bar.html</td> 
  </tr> 
 </tbody> 
</table>

来源于数据《Nginx高性能Web服务器详解》数据