Nginx内置变量

1 概述

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

2 常见内置变量

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

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

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;
}