# nginx 内置全局变量
内置变量存放在 ngx_http_core_module 模块中,变量的命名方式和 apache 服务器变量是一致的。
| 变量 | 解释 | 
|---|---|
| $arg_name | 请求中的的参数名,即“?”后面的arg_name=arg_value形式的arg_name | 
| $args | 与$query_string相同 等于当中URL的参数(GET),如a=1&b=2 | 
| $document_uri | 与$uri相同 这个变量指当前的请求URI,不包括任何参数(见$args) | 
| $request_uri | 包含请求参数的原始URI,不包含主机名,如:/2013/81.html?a=1&b=2 | 
| $is_args | 如果有$args参数,这个变量等于”?”,否则等于”",空值,如? | 
| $query_string | 与$args相同 等于当中URL的参数(GET),如a=1&b=2 | 
| $uri | 这个变量指当前的请求URI,不包括任何参数(见$args) 如:/2013/81.html | 
| $remote_addr | 获取客户端ip | 
| $binary_remote_addr | 客户端ip(二进制) | 
| $remote_port | 客户端port,如:50472 | 
| $remote_user | 已经经过Auth Basic Module验证的用户名 | 
| $host | 请求主机头字段,否则为服务器名称,如:blog.sakmon.com | 
| $request | 用户请求信息,如:GET ?a=1&b=2 HTTP/1.1 | 
| $request_method | 客户端请求的动作,通常为GET或POST,如:GET | 
| $request_filename | 当前请求的文件的路径名,由root或alias和URI request组合而成,如:/2013/81.html | 
| $status | 请求的响应状态码,如:200 | 
| $body_bytes_sent | 响应时送出的body字节数数量。即使连接中断,这个数据也是精确的,如:40,传输给客户端的字节数,响应头不计算在内;这个变量和Apache的mod_log_config模块中的“%B”参数保持兼容 | 
| $content_length | 等于请求行的“Content_Length”的值 | 
| $content_type | 等于请求行的“Content_Type”的值 | 
| $http_referer | 引用地址 | 
| $http_user_agent | 客户端agent信息,如:Mozilla/5.0 (Windows NT5.1) AppleWebKit/537.36(KHTML, like Gecko) Chrome/29.0.1547.76 Safari/537.36;这个可以用来区分手机端还是pc端 | 
| $document_root | 针对当前请求的根路径设置值 | 
| $hostname | 如:centos53.localdomain | 
| $http_cookie | 客户端cookie信息 | 
| $cookie_COOKIE | cookie COOKIE变量的值 | 
| $limit_rate | 这个变量可以限制连接速率,0表示不限速 | 
| $request_body | 记录POST过来的数据信息 | 
| $request_body_file | 客户端请求主体信息的临时文件名 | 
| $scheme | HTTP方法(如http,https),如:http | 
| $request_completion | 如果请求结束,设置为OK. 当请求未结束或如果该请求不是请求链串的最后一个时,为空(Empty),如:OK | 
| $server_protocol | 请求使用的协议,通常是HTTP/1.0或HTTP/1.1,如:HTTP/1.1 | 
| $server_addr | 服务器IP地址,在完成一次系统调用后可以确定这个值 | 
| $server_name | 服务器名称,如:blog.sakmon.com | 
| $server_port | 请求到达服务器的端口号,如:80 | 
| $connection | CP连接的序列号 (1.3.8, 1.2.5) | 
| $connection_requests | CP连接当前的请求数量 (1.3.8, 1.2.5) | 
| $nginx_version | nginx版本 | 
| $pid | 工作进程的PID | 
| $pipe | 如果请求来自管道通信,值为“p”,否则为“.” (1.3.12, 1.2.7) | 
| $proxy_protocol_addr | 获取代理访问服务器的客户端地址,如果是直接访问,该值为空字符串。(1.5.12) | 
| $realpath_root | 当前请求的文档根目录或别名的真实路径,会将所有符号连接转换为真实路径。 | 
