Nginx内置变量

刺骨的言语ヽ痛彻心扉 2023-05-29 11:49 6阅读 0赞

## 1 概述 ##

在客户端发起http或tcp请求的过程中，Nginx提供了很多内置的变量来获取相应的HTTP和TCP的信息。Nginx的内置变量主要是用于日志的记录和分析，以及一些业务逻辑的处理等。

## 2 常见内置变量 ##

Nginx的内置变量会随着版本的不断更新，具体可以参考官方的WIKI：[Alphabetical index of variables][]

<table> 
 <thead> 
  <tr> 
   <th>变量名</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>$arg_<code>name</code></td> 
   <td>URL请求中的参数，name是参数的名字</td> 
  </tr> 
  <tr> 
   <td>$args</td> 
   <td>URL请求中的所有参数</td> 
  </tr> 
  <tr> 
   <td>$content_length</td> 
   <td>HTTP请求信息里的"Content-Length"</td> 
  </tr> 
  <tr> 
   <td>$content_type</td> 
   <td>HTTP请求信息里的"Content-Type"</td> 
  </tr> 
  <tr> 
   <td>$cookie_<code>name</code></td> 
   <td>name为Cookie的名字，可以得到Cookie的信息</td> 
  </tr> 
  <tr> 
   <td>$host</td> 
   <td>请求信息中的Host头域值，如果请求中没有Host行，则等于设置的服务器名</td> 
  </tr> 
  <tr> 
   <td>$http_<code>name</code></td> 
   <td>HTTP请求信息中的header字段，name是字段key</td> 
  </tr> 
  <tr> 
   <td>$request_uri</td> 
   <td>请求的URI，带参数</td> 
  </tr> 
  <tr> 
   <td>$request_method</td> 
   <td>请求的方式，比如POST或GET</td> 
  </tr> 
  <tr> 
   <td>$scheme</td> 
   <td>请求的协议，例如HTTP或HTTPS</td> 
  </tr> 
  <tr> 
   <td>$uri</td> 
   <td>当前请求的URI，在请求过程中URI可能会被改变，例如在内部重定向或使用索引文件时</td> 
  </tr> 
 </tbody> 
</table>

## 3 内置变量的实例 ##

#### $scheme ####

使用该变量来实现HTTP请求重定向跳转到HTTPS请求：  
（注意 if 与左括号是有空格的）

if ($scheme = 'http') {
        
    	rewrite ^/(.*)$ https://$host/$1 redirect;
    }

#### $http\_`name` ####

获取http请求头的值：

upstream backend {
        
        server 192.168.244.1:8080;
    	server 192.168.244.2:8080;
        server 192.168.244.3:8080;
        server 192.168.244.4:8080;
    	hash $http_userid consistent;
    }

#### $cookie\_`name` ####

获取cookie的值：

upstream backend {
        
        server 192.168.128.1:8080 srun_id=123456;
        server 192.168.128.2:8080 srun_id=654321;
        jvm_route $cookie_jtzen9SID reverse;
    	keepalive 32;
    }

[Alphabetical index of variables]: https://nginx.org/en/docs/varindex.html