nginx - 全局变量和指令

全局变量

下面是可以用作if判断的全局变量

	$args ： 这个变量等于请求行中的参数，同$query_string
	$content_length ： 请求头中的Content-length字段。
	$content_type ： 请求头中的Content-Type字段。
	$document_root ： 当前请求在root指令中指定的值。
	$host ： 请求主机头字段，否则为服务器名称。
	$http_user_agent ： 客户端agent信息
	$http_cookie ： 客户端cookie信息
	$limit_rate ： 这个变量可以限制连接速率。
	$request_method ： 客户端请求的动作，通常为GET或POST。
	$remote_addr ： 客户端的IP地址。
	$remote_port ： 客户端的端口。
	$remote_user ： 已经经过Auth Basic Module验证的用户名。
	$request_filename ： 当前请求的文件路径，由root或alias指令与URI请求生成。
	$scheme ： HTTP方法（如http，https）。
	$server_protocol ： 请求使用的协议，通常是HTTP/1.0或HTTP/1.1。
	$server_addr ： 服务器地址，在完成一次系统调用后可以确定这个值。
	$server_name ： 服务器名称。
	$server_port ： 请求到达服务器的端口号。
	$request_uri ： 包含请求参数的原始URI，不包含主机名，如：”/foo/bar.php?arg=baz”。
	$uri ： 不带请求参数的当前URI，$uri不包含主机名，如”/foo/bar.html”。
	$document_uri ： 与$uri相同。

$host_host变量，和$host区别如下：

$host不带端口，$http_host带端口

例：http://localhost:88/test1/test2/test.php

	$host：localhost
	$server_port：88
	$request_uri：http://localhost:88/test1/test2/test.php
	$document_uri：/test1/test2/test.php
	$document_root：/var/www/html
	$request_filename：/var/www/html/test1/test2/test.php

if判断指令

语法为if(condition){...}，对给定的条件condition进行判断。如果为真，大括号内的rewrite指令将被执行，if条件(conditon)可以是如下任何内容：

• 当表达式只是一个变量时，如果值为空或任何以0开头的字符串都会当做false
• 直接比较变量和内容时，使用=或!=
• ~正则表达式匹配，~*不区分大小写的匹配，!~区分大小写的不匹配

注意：使用正则表达式字符串一般不需要加引号，但是如果含有右花括号“}”或者分号“；”字符时，必须要给整个正则表达式加引号

其他指令：

-f和!-f用来判断是否存在文件
-d和!-d用来判断是否存在目录
-e和!-e用来判断是否存在文件或目录
-x和!-x用来判断文件是否可执行

break指令

用于中断当前相同作用域中的Nginx配置，和Java中的break语法类似，可以在server块和location以及if块中使用。

语法：break;

return指令

该指令用于完成对请求的处理，直接向客户端响应状态的代码。和Java中的return语法类似。可以再server块和location以及if块中使用。
语法：return code URL; #code表示状态码，URL表示返回给客户单的URL地址
或者：return URL: #当状态码是302或者307的时候，可以使用，返回的URL必须包含“http://”、“https://”或者直接使用“$scheme”变量(RequestScheme代表传输协议，
Nginx内置变量)
或者 return [text]; #为返回给客户端的响应体内容，支持变量的使用

rewrite指令

该指令通过正则表达式的使用来改变URI.可以同时存在一个或者多个指令，按照顺序一次对URL进行匹配和处理。该指令可以在server块后者location块中配置

语法：

指令语法：rewrite regex replacement [flag];

rewrite：是实现URL重定向的重要指令， 　
regex：用来匹配URI的正则表达式；
replacement：匹配成功后用来替换URI中被截取内容的字符串，默认情况如果该字符串包含“http://”、"https://"开头，则不会继续向下对URI进行其他处理。直接返回重写的URI给客户端
flag：用来设置rewrite对URI的处理行为,包含如下数据：

传参

rewrite ^/test.php /new permanent; //重写向带参数的地址
rewrite ^/test.php /new? permanent; //重定向后不带参数
rewrite ^/test.php /new?id=$arg_id? permanent; //重定向后带指定的参数

rewrite_log指令

该指令用于是否开启URL重写日志的输出，

语法：

rewrite_log on | off

默认是off，如果配置为on，URL重写的相关日志将以notice级别输出到error_log指令配置的日志文件中

set指令

用来设置新的变量，

语法: set variable value;

variable,这个是变量的名称，这个符号的“$”必须作为变量第一个字符，并且不能和Nginx服务器预设的全局变量同名

value,为变量的值。

比如 set $id “3”; #设置id为3

uninitialized_variable_warn指令

这个指令用来配置会用未初始化的变量时，是否记录警告日志，
语法： unitialized_variable_warn on | off
默认设置时on状态

防盗链

语法：
valid_referers none | blocked | server_name | string ...;
这里表示请求头部Referer域是否匹配上面值，如果匹配了$invalid_referer 的值为0，没有相匹配就是1；

example:

	if (-f $request_filename){
	… #判断请求的文件是否存在，存在就执行这里面的代码块
	}
	if ($http_user_agent ~ MSIE) {
	rewrite ^(.*)$ /msie/$1 break;
	} //如果UA包含"MSIE"，rewrite请求到/msid/目录下
	if ($http_cookie ~* "id=([^;]+)(?:;|$)") {
	set $id $1;
	} //如果cookie匹配正则，设置变量$id等于正则引用部分
	if ($request_method = POST) {
	return 405;
	} //如果提交方法为POST，则返回状态405（Method not allowed）。return不能返回301,302
	if ($slow) {
	limit_rate 10k;
	} //限速，$slow可以通过 set 指令设置
	if (!-f $request_filename){
	break;
	proxy_pass http://127.0.0.1;
	} //如果请求的文件名不存在，则反向代理到localhost 。这里的break也是停止rewrite检查
	if ($args ~ post=140){
	rewrite ^ http://example.com/ permanent;
	} //如果query string中包含"post=140"，永久重定向到example.com
	location ~* \.(gif|jpg|png|swf|flv)$ {
	valid_referers none blocked www.jefflei.com www.leizhenfang.com;
	if ($invalid_referer) {
	return 404;
	} //防盗链
	}

参考资料

nginx重定向到其他url方法_Nginx之URL重写（rewrite）配置
Nginx if指令与全局变量