Nginx Rewirte指令 _Nginx

笛里谁知壮士心，沙头空照征人骨。这篇文章主要讲述Nginx Rewirte指令相关的知识，希望能为你提供帮助。
Rewirtenginx服务器利用 ngx_http_rewrite_module 模块解析和处理rewrite请求，此功能依靠 PCRE(perlcompatible regular expression)，因此编译之前要安装PCRE库，rewrite是nginx服务器的重要功能之一，用于实现URL的重写，URL的重写是非常有用的功能，类似网络中的重定向
应用场景：

URL看起来更规范、合理
企业会将动态URL地址伪装成静态地址提供服务
网址换新域名后，让旧的访问跳转到新的域名.上
服务端某些业务调整
常见搭配location、rewrite & if

ngx_http_rewrite_module 模块指令 IF指令
用于条件匹配判断，并根据条件判断结果选择不同的Nginx配置，可以配置在server或location块中进行配置，Nginx的if语法仅能使用if做单次判断，不支持使用if else或者if elif这样的多重判断，用法如下：

if （条件匹配）
action

使用正则表达式对变量进行匹配，匹配成功时if指令认为条件为true，否则认为false，变量与表达式之间使用以下符号链接：

#注意：
#如果$变量的值为空字符串或0，则if指令认为该条件为false，其他条件为true。
#nginx 1.0.1之前$变量的值如果以0开头的任意字符串会返回false
#示例：
location /main
index index.html;
default_type text/html;
if ( $scheme = http )
echo "if-----> $scheme";

if ( $scheme = https )
echo "if ----> $scheme";

#if (-f $request_filename)
# echo "$request_filename is exist";
#
if (!-e $request_filename)
echo "$request_filename is not exist";
#return 409;

测试语法：

测试结果，原应该跳404的，if判断跳403成功

SET指令
指定key并给其定义一个变量，变量可以调用Nginx内置变量赋值给key，另外set定义格式为set $key value，value可以是text, variables和两者的组合。

location /main
root /data/nginx/html/pc;
index index.html;
default_type text/html;
set $name test;
echo $name;
set $my_port $server_port;
echo $my_port;

break 指令
用于中断当前相同作用域(location)中的其他Nginx配置，与该指令处于同一作用域的Nginx配置中，位于它前面的配置生效，位于后面的 ngx_http_rewrite_module 模块中指令就不再执行，Nginx服务器在根据配置处理请求的过程中遇到该指令的时候，回到上一层作用域继续向下读取配置，该指令可以在server块和locationif块中使用

#示例
if ($slow)
limit_rate 10k;
break;

location /main
root /data/nginx/html/pc;
index index.html;
default_type text/html;
set $name test;
echo $name;
break; #location块中break后面指令还会执行
set $my_port $server_port;
echo $my_port;

return 指令
return用于完成对请求的处理，并直接向客户端返回响应状态码，比如:可以指定重定向URL(对于特殊重定向状态码，301/302等) 或者是指定提示文本内容(对于特殊状态码403/500等)，处于此指令后的所有配置都将不被执行，return可以在server、if 和 location块进行配置
语法格式：

return code; #返回给客户端指定的HTTP状态码
return code [text]; #返回给客户端的状态码及响应报文的实体内容，可以调用变量,其中text如果有空格,需要用单或双引号
return code URL; #返回给客户端的URL地址

#示例
location /
root /data/nginx/html/pc;
default_type text/html;
index index.html;
if ( $scheme = http )
#return 666;
#return 666 "not allow http";
#return 301 http://www.baidu.com;
return 500 "service error";
echo "if-----> $scheme"; #return后面的将不再执行

if ( $scheme = https )
echo "if ----> $scheme";

测试语法

测试结果，从浏览器抓包看到跳转成功。如果用301测试，记得清除缓存

rewrite 指令通过正则表达式的匹配来改变URI，可以同时存在一个或多个指令，按照顺序依次对URI进行匹配，rewrite主要是针对用户请求的URL或者是URI做具体处理，rewrite可以配置在 server、location、if

语法格式：
rewrite regex replacement [flag];

rewrite flag 使用
利用nginx的rewrite的指令，可以实现url的重新跳转，rewrtie有四种不同的flag，分别是redirect(临时重定向302)、permanent(永久重定向301)、break和last。其中前两种是跳转型的flag，后两种是代理型

跳转型指由客户端浏览器重新对新地址进行请求
代理型是在WEB服务器内部实现跳转

rewrite 格式

Syntax: rewrite regex replacement [flag]; #通过正则表达式处理用户请求并返回替换后的数据包。
Default: —
Context: server, location, if

flag 说明

redirect;
#临时重定向，重写完成后以临时重定向方式直接返回重写后生成的新URL给客户端，由客户端重新发起请求;
#使用相对路径,或者http://或https://开头，状态码：302

permanent;
#重写完成后以永久重定向方式直接返回重写后生成的新URL给客户端，由客户端重新发起请求，状态码：301

break;
#重写完成后,停止对当前URL在当前location中后续的其它重写操作，而后直接跳转至重写规则配置块之后
#的其它配置; 结束循环，建议在location中使用
#适用于一个URL一次重写

last;
#重写完成后,停止对当前URI在当前location中后续的其它重写操作，而后对新的URL启动新一轮重写检查，
#不建议在location中使用
#适用于一个URL多次重写，要注意避免出现超过十次以及URL重写后返回错误的给用户