说明

Nginx 同 Apache 和 Lighttpd 等其他 Web 服务器的配置记法不太相同， Nginx 的配置文件使用语法的就是一门微型的编程语言。
可以类似写程序一般编写配置文件， 可操作性很大。
既然是编程语言， 一般也就少不了“变量”这种东西。
所有的 Nginx 变量在 Nginx 配置文件中引用时都须带上 $ 前缀在 Nginx 配置中，
变量只能存放一种类型的值， 有且也只存在一种类型， 那就是字符串类型。

#使用 set 配置指令对变量 $a 进行了赋值操作
set $hello "hello world" ;

Nginx 变量一旦创建， 其变量名的可见范围就是整个 Nginx 配置， 甚至可以跨越不同虚拟主机的server 配置块
Nginx 变量名的可见范围虽然是整个配置， 但每个请求都有所有变量的独立副本， 或者说都有各变量用来存放值的容器的独立副本， 彼此互不干扰。

Nginx 内置变量

内置变量存放在 ngx_http_core_module 模块中

参数名称

注释

$arg_PARAMETER HTTP

请求中某个参数的值， 如/index.php?name=www.baidu.com， 可以用$arg_name取得www.baidu.com这个值

$args HTTP

请求中的完整参数。 例如， 在请求/index.php?width=400&height=200 中， $args表示字符串width=400&height=200.

$binary_remote_addr

二进制格式的客户端地址。 例如： \x0A\xE0B\x0E

$body_bytes_sent

表示在向客户端发送的http响应中， 包体部分的字节数

$content_length

表示客户端请求头部中的Content-Length 字段

$content_type

表示客户端请求头部中的Content-Type 字段

$cookie_COOKIE

表示在客户端请求头部中的cookie 字段

$document_root

表示当前请求所使用的root 配置项的值

$uri

表示当前请求的URI， 不带任何参数

$document_uri

与$uri含义相同

$request_uri

表示客户端发来的原始请求URI， 带完整的参数。

后的URI， 而

$request_uri 永远不会改变， 始终是客户端的原始URI.

$host

表示客户端请求头部中的Host字段。 如果Host字段不存在， 则以实际处理的server（虚拟主机） 名称代替。 如果Host字段中带有端口， 如IP:PORT， 那么$host是去掉端口的， 它的值为IP。 $host 是全小写的。 这些特性与http_HEADER中的http_host不同， http_host只取出Host头部对应的值。

$hostname

表示 Nginx所在机器的名称， 与 gethostbyname调用返回的值相同

$http_HEADER

表示当前 HTTP请求中相应头部的值。 HEADER名称全小写。 例如， 示请求中 Host头部对应的值 用 $http_host表示

$sent_http_HEADER

表示返回客户端的 HTTP响应中相应头部的值。 HEADER名称全小写。 例如， 用 $sent_ http_content_type表示响应中ContentType头部对应的值

$is_args

表示请求中的 URI是否带参数， 如果带参数， $is_args值为 ?， 如果不带参数， 则是空字符串

$limit_rate

表示当前连接的限速是多少， 0表示无限速

$nginx_version

表示当前 Nginx的版本号

$query_string

请求 URI中的参数， 与 $args相同， 然而 $query_string是只读的不会改变

$remote_addr

表示客户端的地址

$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、 PUT、 POST等

$scheme

表示 HTTP scheme，如在请求 https://nginx.com/中

$server_addr

表示服务器地址

$server_name

表示服务器名称

$server_port

表示服务器端口

$server_protocol

表示服务器向客户端发送响应的协议， 如 HTTP/1.1或 HTTP/1.0