# 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 | 当前请求的文档根目录或别名的真实路径,会将所有符号连接转换为真实路径。 |