Nginx的Http请求11个阶段之rewrite阶段:如何灵活使用rewrite

rewrite模块中如果执行了 return指令，那么后面的阶段都没有机会执行。

那么return指令的语法是怎么样的？

主要有3种:

return code [text]; 
return code URL; 
return URL;

444 这个状态码，浏览器是收不到这个code的。这是Nginx自定义的状态码。

表示Nginx立刻关闭连接，不再向用户返回任何内容。

/* Our own HTTP codes */ 
/* The special code to close connection without any response */ 
#define NGX_HTTP_CLOSE 444 
#define NGX_HTTP_NGINX_CODES 494 
#define NGX_HTTP_REQUEST_HEADER_TOO_LARGE 494 
#define NGX_HTTPS_CERT_ERROR 495 
#define NGX_HTTPS_NO_CERT 496

return指令与error_page

我们经常用看到Nginx配置中有error_page。

error_page的意思实际上是 当收到某一个返回码的时候，可以重定向为另外一个uri,也可以指定给用户返回不一样的内容。

可以出现的范围http,server, location, if

常见案例：404页面，找不到该页面的时候，我们想返回给用户一些用户体验较好的页面，比如寻找走失儿童或者保护环境等。

rewrite指令

语法:

rewrite regex replacement [flag];

作用:

1. 匹配上正则表达式regex的url 替换成replacement（新的url ） ,flag 是表示行为。

2. 当replacement以http:// 或 https://或 $schema开头，则直接返回302重定向

3. 替换后的url根据flag指定的方式进行处理

flag 的选项：

--last:用replacement这个新的URI 重新在我们的location中进行匹配。

--break: break指令停止当前脚本指令的执行。

--redirect:返回302重定向

--permanent:返回301重定向

为了巩固一下 我们来看一个例子:

html下有3个目录, 并放入3个文件。内容分别是 test1 test2 test3。

cd html mkdir first second third 
echo "test1" > html/first/1.txt 
echo "test2" > html/second/2.txt 
echo "test3" > html/third/3.txt

nginx.conf如下

server { 
  		server_name rewrite.local.com; 
        rewrite_log on; 
        error_log logs/rewrite_error.log notice; 
  			root html/; 
        location /first { 
          rewrite /first(.*) /second$1 last; 
          return 200 'first!\n'; 
        } 
  
        location /second { 
          rewrite /second(.*) /third$1; 
          return 200 'second!\n'; 
        }
  
		  	location /third { 
          return 200 'third!\n'; 
        } 
}

此时 我们请求会返回什么呢？

curl return.local.com/first/3.txt

结果是

原因是因为

在匹配到/first的时候 被rewrite 成了second flag是last，就到上层去重新匹配了。

此时匹配到了第二个location /second,进来又被rewrite了，但是没有last,也没有break。于是继续执行return 200 'second!\n';

在第二个location里都已经return了。 第三个location就没有机会执行了。

那么我们再变化一下将第二个location变成以下

 location /second { 
   rewrite /second(.*) /third$1 last; 
   return 200 'second!\n'; 
 }

此时 我们请求会返回什么呢？

curl return.local.com/first/3.txt

结果是

这个想必大家都知道结果了。最后被匹配到第三个location里了。

那么我们再变化一下将第二个location变成以下 区别一下break和 last的区别

location /second { 
  rewrite /second(.*) /third$1 break; 
  return 200 'second!\n'; 
}

此时 我们请求会返回什么呢？

curl return.local.com/first/3.txt

结果是

这是因为在location /second里被rewrite后，flag为break 就不执行下面的return; 也不返回重新匹配localtion 而是停止了 直接请求third/3.txt了。

好了，今天就先到这里了，明天我们继续学习http请求处理的 find_config阶段。