nginx——rewrite配置

nginx的rewrite配置-if

• 域名跳转（重定向）/ URL重写（伪静态） / 动静分离（跳转域名，并接入CDN实现加速
  (1).依赖PCRE库
  (2).使用到的模块是：ngx_http_rewrite_module

• rewrite相关指令
  （1）if（条件）

if指令
格式：if (条件判断) { 具体的rewrite规则 }
条件举例
条件判断语句由Nginx内置变量、逻辑判断符号和目标字符串三部分组成。
其中，内置变量是Nginx固定的非自定义的变量，如，$request_method, $request_uri等。
逻辑判断符号，有=, !=, ~, ~*, !~, !~*
!表示相反的意思，~为匹配符号，它右侧为正则表达式，区分大小写，而~*为不区分大小写匹配。
目标字符串可以是正则表达式，通常不用加引号，但表达式中有特殊符号时，比如空格、花括号、分号等，需要用单引号引起来。
示例1
if ($request_method = POST)  //当请求的方法为POST时，直接返回405状态码
{
    return 405; //在该示例中并未用到rewrite规则，if中支持用return指令。
}
示例2
if ($http_user_agent ~ MSIE) //user_agent带有MSIE字符的请求，直接返回403状态码
{
    return 403;
}

如果想同时限制多个user_agent，还可以写成这样

if ($http_user_agent ~ "MSIE|firefox|spider")
{
    return 403;
}
示例3
if(!-f $request_filename)  //当请求的文件不存在，将会执行下面的rewrite规则
{
    rewrite 语句;
}
示例4
if($request_uri ~* 'gid=\d{9,12}/')  //\d表示数字，{9,12}表示数字出现的次数是9到12次，如gid=123456789/就是符合条件的。
{
    rewrite 语句;
}

• rewrite中的break和last

两个指令用法相同，但含义不同，需要放到rewrite规则的末尾，用来控制重写后的链接是否继续被nginx配置执行（主要是rewrite和return指令）
示例1（连续两条rewrite规则）
server{
     	listen 80;
     	server_name test.com;
     	root  /tmp/test.com;

		rewrite  /1.html   /2.html ;
		rewrite  /2.html  /3.html ; 
}		
当我们请求1.html时，最终访问到的是3.html,两条rewrite规则先后执行

break和last在location{}外部

格式：rewrite xxx break；
示例2（增加break）：
server{
		listen  80；
		server_name test.com;
		root   /root/test.com;

    	rewrite  /1.html  /2.html break ;
    	rewrite  /2.html  /3.html ;
 }
当我们在请求1.html时，最终访问到的是2.html
说明break在示列中，作用是不再执行break以下的rewrite规则。

但当配置文件中有location时，它还会去执行location{}段的配置

示例3（break后面还有location段）：   
server{
		listen   80；
		server_name  test.com;
		root	  /tmp/test.com

		rewrite  /1.html  /2.html  break;
		rewrite  /2.html  /3.html;
		location	/2.html {
				return 403;
		}
	}
	当请求1.html时，最终会返回403状态码，说明它去匹配了break后面的location{}配置
	以上2个示例中，可以把break替换未last，它们起到的作用是相同的。	
			

当break和last在location{}里面

示例4（什么都不加）；
server{
		listen	80;
		server_name	test.com;
		root	/tmp/test.com;

		location	/	{
				rewrite		/1.html		/2.html;
				rewrite 	/2.html 	/3.html;
		}
		location  /2.html
		{
				rewrite	/2.html		/a.html;
		}
		location	/3.html
		{	
				rewrite		/3.html		/b.html;
		}
}
当请求/1.html,最终将会访问到/b.html，连续执行location /下的2次rewrite，跳转到了/3.html，然后又匹配location /3.html

示例5（增加break）：
server{
		listen	80;
		server_name	test.com;
		root	/tmp/test.com;
		
		location	/	{
				rewrite		/1.html		/2.html		break;
				rewrite		/2.html 	/3.html ;
		}
		location  /2.html
		{
				rewrite	/2.html		/a.html;
		}
		location	/3.html
		{	
				rewrite		/3.html		/b.html;
		}
}
遇到break后，之后的都不在执行。前提是要在location里面使用break
在使用last的时候，它是匹配到精准位置才会结束。

总结：
（1）如果break和last在server里面，那么它们的作用是一样的，遇到break或者last,那么后面得不会再执行。
（2）如果break或者last在location中
1）break：本location段的规则不会执行，其他的location也不执行
2）last：本location段的规则不会执行，但是重写后的URL会重新走一遍，匹配哪个location，就执行哪个location

aming总结：
A：当rewrite规则在location{}外，break和last作用一样，遇到break和last后，其后续的rewrite/return语句不再执行，但后续有location{}的话，还会近一步执行location{}里面的语句
B：当rewrite规则在location{}里，遇到break后，本location{}与其他location{}的所有rewrite/return规则都不再执行
C：当rewrite规则在location{}里，遇到last后，本location{}里后续rewrite/return规则不执行，但重写后的URL再次从头开始执行所有规则，哪个匹配执行哪个

nginx中的return用法

-nginx的return指令

该指令一般用于对请求的客户端直接返回响应状态码，在该作用域内return后面的所有nginx配置都是无效的。
可以使用在server和location以及if配置中。
除了支持跟状态码，还可以跟字符串或者URL链接

• 直接返回状态码

示例1：
server{
		listen	80;
		server_name	www.test.com;
		return	403;
		rewrite		/(.*) 	/abc/$1; (该行配置不会被执行）
}

示例2：
server{
		listen	80;
		server_name	test.com;
		root	/tmp/test.com;
if	（ $request_uri	~ 	“\.htpasswd|\.bak" ）
    {
		return 404;
		rewrite 	/(.*)	/aaa.txt;  (该行不会被执行）
	 }
}

• 返回字符串

示例3：
server{
		listen  80;
		server_name www.test.com;
		return 200 "hello";
}
说明：如果要想返回字符串，必须要加上状态码，否则会报错。还可以支持json数据

示例4：
location 	^~  /test {
 		default_type	application/json	;
 		return	200 '{"name":"test","id":"100"}‘;
 }
 也支持写一个变量

示例5：
location  / test {
		return 200 ”$host  $request_uri";
}

返回URL

示例6：
server{
		listen	80；
		server_name  www.test.com;
		return	http://www.testlinux.com/123.html;
		rewrite	/(.*) 	/abc/$1; //该行不会被执行。
}
注意：return后面的url必须是以http://或是https://开头的。