Nginx 的系统变量是由每一个编译进Nginx的模块提供的。而用户也可以自己定义变量。

变量的特性

• 惰性求值：当使用到这个变量时才会求其值。所以不会有性能上的问题。而惰性求值也带来了第二个特性。变量值动态改变。
• 变量值动态改变：一个变量的内容是动态变化的，其值为使用的那一时刻的值。

存放变量

对于频繁使用的变量，其值被存放在哈希表中

• variables_hash_bucket_size size;
  对于变量名特别长的，需要增大（默认64 byte）
• variables_hash_max_size size;
  对于变量特别多的，需要最大（默认1024 byte）

变量种类

如下有一个nginx配置

log_format var_log '$remote_addr - $remote_user [$time_local] "$request" '
                '$status bytes_sent=$bytes_sent body_bytes_sent=$body_bytes_sent "$http_referer"'
                '"$http_user_agent" "$sent_http_abc"';

server {
        listen 80;
        server_name var.loki.wjx localhost;
        access_log logs/var.log var_log;

        location / {
                set $limit_rate 10k;
                return 200 '
arg_a: $arg_a, arg_b: $arg_b, args: $args
connection: $connection, connection_requests: $connection_requests
cookie_a: $cookie_a
uri: $uri, document_uri: $document_uri, request_uri: $request_uri
request: $request , request_id: $request_id
server: $server_addr, $server_name, http_host: $http_host,
limit_rate: $limit_rate, hostname: $hostname,
content_length: $content_length
status: $status, body_bytes_sent: $body_bytes_sent, bytes_sent: $bytes_sent
time: $request_time, $msec, $time_iso8601, $time_local\n';
        }
}

使用curl访问后可以看到

$ curl -H 'Host:var.loki.wjx' -H'Content-Length: 10' -H'Cookie: a=c1' 'http://127.0.0.1?a=1&b=2'

arg_a: 1, arg_b: 2, args: a=1&b=2
connection: 8, connection_requests: 1
cookie_a: c1
uri: /, document_uri: /, request_uri: /?a=1&b=2
request: GET /?a=1&b=2 HTTP/1.1 , request_id: a08f79326436532975b68563ff5129b7
server: 127.0.0.1, var.loki.wjx, http_host: var.loki.wjx,
limit_rate: 10240, hostname: loki,
content_length: 10
status: 200, body_bytes_sent: 0, bytes_sent: 0
time: 0.000, 1558537313.937, 2019-05-22T11:01:53-04:00, 22/May/2019:11:01:53 -0400

这里的 content_length body_bytes_sent bytes_sent 都是0，因为这个时候，这些变量的值都还是0。

常见的nginx 变量

TCP相关的变量

Nginx 处理请求过程中产生的变量

Nginx系统变量