# 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_COOKIEcookie COOKIE变量的值
$limit_rate这个变量可以限制连接速率,0表示不限速
$request_body记录POST过来的数据信息
$request_body_file客户端请求主体信息的临时文件名
$schemeHTTP方法(如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
$connectionCP连接的序列号 (1.3.8, 1.2.5)
$connection_requestsCP连接当前的请求数量 (1.3.8, 1.2.5)
$nginx_versionnginx版本
$pid工作进程的PID
$pipe如果请求来自管道通信,值为“p”,否则为“.” (1.3.12, 1.2.7)
$proxy_protocol_addr获取代理访问服务器的客户端地址,如果是直接访问,该值为空字符串。(1.5.12)
$realpath_root当前请求的文档根目录或别名的真实路径,会将所有符号连接转换为真实路径。
上次更新: 7/11/2023, 6:25:26 PM