• 进入"运维那点事"后,希望您第一件事就是阅读“关于”栏目,仔细阅读“关于Ctrl+c问题”,不希望误会!

Nginx内置变量介绍

Nginx 彭东稳 8年前 (2016-06-25) 21183次浏览 已收录 0个评论

变量

Nginx Core module支持一些内置的变量,与apache使用的变量相一致。

首先,一些变量代表了客户端请求头部的一些字段,如:$http_user_agent, $http_cookie等等。注意,由于这些变量会在请求中定义,所以可能无法保证他们是存在的或者说可以定义到一些别的地方(例如遵循一定的规范)。除此之外,下列是一些其他变量:

$arg_PARAMETER

这个变量包含在查询字符串时GET请求PARAMETER的值。

$args

这个变量等于请求行中的参数。

$binary_remote_addr

二进制码形式的客户端地址。

$body_bytes_sent

应答实体大小,即使连接失败或中断,它也非常精确。

$content_length

请求头中的Content-length字段。

$content_type

请求头中的Content-Type字段。

$cookie_COOKIE

cookie COOKIE的值。

$document_root

当前请求在root指令中指定的值。

$document_uri

与$uri相同。

$host

请求中的Host字段,如果请求中的Host字段不可用,则为服务器处理请求的服务器名称。在下列情况下,$host变量的值可能和$http_host的值不相同:

当请求头中的Host字段未指定或者为空值,$host等于server_name指令指定的值。

当Host字段包含端口号时,$host并不包含端口号,$host的值在0.8.17后总是小写。

$hostname

gethostname返回的机器名称。

$is_args

如果$args设置,值为”?”,否则为”“。

$limit_rate

这个变量可以限制连接速率。

$nginx_version

当前运行的nginx版本号。

$query_string

与$args相同。

$remote_addr

客户端的IP地址。

$remote_port

客户端的端口。

$remote_user

已经经过Auth Basic Module验证的用户名。

$request_filename

当前连接请求的文件路径,由root或alias指令与URI请求生成。

$request_body

这个变量(0.7.58+)包含请求的主要信息。在使用proxy_pass或fastcgi_pass指令的location中比较有意义。

$request_body_file

客户端请求主体信息的临时文件名。

$request_completion

如果请求成功,值为”OK”,如果请求未完成或者请求不是一个范围请求的最后一部分,则为空。

$request_method

这个变量是客户端请求的动作,通常为GET或POST。
包括0.8.20及之前的版本中,这个变量总为main request中的动作,如果当前请求是一个子请求,并不使用这个当前请求的动作。

$request_uri

这个变量等于包含一些客户端请求参数的原始URI,它无法修改,请查看$uri更改或重写URI,不包含主机名,例如:”/foo/bar.php?arg=baz”。

$scheme

HTTP方法(如http,https)。按需使用,例:rewrite ^ $scheme://example.com$uri redirect;

$server_addr

服务器地址,在完成一次系统调用后可以确定这个值,如果要绕开系统调用,则必须在listen中指定地址并且使用bind参数。

$server_name

服务器名称。

$server_port

请求到达服务器的端口号。

$server_protocol

请求使用的协议,通常是HTTP/1.0或HTTP/1.1。

$uri

请求中的当前URI(不带请求参数,参数位于$args),可以不同于浏览器传递的$request_uri的值,它可以通过内部重定向,或者使用index指令进行修改,$uri不包含主机名,如”/foo/bar.html”。


如果您觉得本站对你有帮助,那么可以支付宝扫码捐助以帮助本站更好地发展,在此谢过。
喜欢 (1)
[资助本站您就扫码 谢谢]
分享 (0)

您必须 登录 才能发表评论!