欢迎访问源站nginx 全套教程记录

nginx Rewrite规则可以让网站的url中达到某种状态时定向/跳转到某个规则，可以实现很多功能。

• url访问跳转，支持开发设计，页面跳转、兼容性支持、展示效果、301重定向等。
• SEO优化
• 维护，流量转发
• 安全，如伪静态

内置的全局变量

1.rewrite模块

rewrite配置项属于ngx_http_rewrite_module模块传送门{:target="_blank"}

rewrite

Syntax:	rewrite regex replacement [flag];  #匹配规则 定向路径 标志参数
Default: —
Context: server, location, if

break

停止处理当前的ngx_http_rewrite_module指令集。

Syntax:	break;
Default: —
Context: server, location, if

if

如果为true，则执行在大括号内指定的此模块指令，并在if指令内为该请求分配配置

Syntax:	if (condition) { ... }
Default: —
Context: server, location

条件可以是以下任何一种：

• 如果变量的值为空字符串或“0”，则为false;
• 使用=和`!=运算符比较变量和字符串;
• 使用~（对于区分大小写的匹配）和~*（对于不区分大小写的匹配）运算符，将变量与正则表达式进行匹配。正则表达式可以包含可供以后在$1 … $9变量中重用的捕获。负操作符!~和!~*也可用。如果正则表达式包含}或;字符，则整个表达式应包含在单引号或双引号中。
• 使用-f和!-f运算符检查文件是否存在
• 使用-d和!-d运算符检查目录是否存在
• 使用-e和!-e运算符检查文件，目录或符号链接是否存在
• 使用-x和!-x运算符检查可执行文件。

return

该指令用于结束规则的执行并返回状态码给客户端。

Syntax:	return code [text];
	return code URL;
	return URL;
Default: —
Context: server, location, if

set

Syntax:	set $variable value;
Default: —
Context: server, location, if

2.调试rewrite是否正确

nginx中要检测rewrite是否正确，就需要开启rewrite_log才能排错，rewrite_log会打印错误。检测完后，建议将rewrite_log关闭。

rewrite_log

Syntax:	rewrite_log on | off;
Default: rewrite_log off;
Context: http, server, location, if

示例：

rewrite_log on；
error_log /var/log/nginx/rewrite.log notice;

3.break和last区别

rewrite里面flag中break和last是什么区别？请看下面的例子

root /opt/app/code; 

location ~ ^/break {
	rewrite ^/break /test/ break;
} 

location ~ ^/last {
	 rewrite ^/last /test/ last;
}    

location /test/ {
   default_type application/json;
   return 200 '{"status":"success"}';
}

break是停止处理当前的ngx_http_rewrite_module指令集，就是说不会在向下匹配新的location，last停止处理当前的ngx_http_rewrite_module指令集并开始搜索与更改的URI匹配的新位置;

假设我们在页面上访问的url是http://walidream.com/break，根据上面的nginx规则，肯定会匹配到第一个，匹配到第一个之后，根据rewrite正则，url由原来的/break变为/test/但是在root/opt/code/目录
下，没有找到/test/目录下面的内容，所以nginx会返回404错误码。

如果将http://walidream.com/break换成http://walidream.com/last，根据上面的nginx规则，会匹配到第二个location，根据location里面rewrite正则，url由原来的/last变为/test/，但是会重新
匹配loction中，可以简单理解就是将替换后urlhttp://walidream.com/test重新发起一次请求。这个时候会匹配到第三个loaction，根据location里的rewrite正则，会反会200码，并且会返回json内容’{“status”:“success”}’

4.redirect和permanent区别

rewrite里面flag中redirect(临时重定向)和permanent(永久重定向)是什么区别？请看下面的例子

location ~ ^/imooc { 
	rewrite ^/imooc http://www.imooc.com/ redirect;
} 

location ~ ^/wali {
	rewrite ^/wali http://www.imooc.com/ permanent;
}

redirect会返回带有302代码的临时重定向，permanent会返回带有301代码的永久重定向。

假设我们在页面上访问url是http://walidream.com/imooc，根据nginx匹配规则会匹配到第一个location，会重写url，返回一个带有302状态代码，重写后的url是http://www.imooc.com，浏览器会重定向到这个网址，
当我们再次访问http://walidream.com/imooc，nginx还是会先匹配在替换然后重定向。

如果在页面上输入http://walidream.com/wali，根据nginx匹配规则会匹配到第二个location，会重写url，返回一个带有301状态码，重写后的url是http://www.imooc.com，浏览器会重新定向到这个网址，
当我们再次访问http://walidream.com/wali，这个时候浏览器根本不会在经过nginx，而是直接有浏览器重定向到这个网址。

5.rewrite优先级

我们知道rewrite的执行环境是server,location,if。那就有一个问题，当这三个执行环境中都存在rewrite规则，那么执行优先级是什么。

server > location > if

6.利用变量或者return调试

不知道大家写了这么长时间的nginx有没有感觉nginx很难调试，调试一个错误要很长时间。比如上面rewrite 这个就没办法检测自己规则是否在的正确，没有输出，所以要验证rewrite正则是否正确，就要打开
rewrite_log日志，如果匹配错了，日志会记录错误信息。

向一般的检测语法，我们可以利用变量return 返回。

location ~ ^/wali {
	default_type application/json;
	return 200 '{"status":"success"}';
}

location ~ ^/yagm {
	default_type application/json;
	return 200 '{"status":"error"}';
}

这样有时候在调试时会让我们变得稍微方便一点，还有nginx扩展模块如echo就能直接输出内容或者打印内部变量。我们调试起来就更方便了，下面小菜抽一点时间，来讲讲如何安装echo模块。nginx echo传送门{:target="_blank"}