下载掌阅APP，畅读海量书库
立即打开
rewrite是ngx_http_rewrite_module模块下的指令，使用频率非常高，本节会列举一些rewrite的常见配置。
rewrite支持的配置环境有server、location、if，它通过break和last来完成内部重定向功能。内部重定向是在Nginx内部发送请求的操作，它可以将请求转发到其他的location或对URL进行修改，而不必通过HTTP连接请求，整个操作非常高效。
相关示例如下：
如果需要将内部重定向的请求记录到日志里，请使用rewrite_log。
指令：rewrite_log
语法：rewrite_log on|off;
默认值：rewrite_log off;
环境：http、server、location、if
注意： 在rewrite后面跟随的参数始终是正则表达式，并且当内部重定向时URL的参数是不会丢失的。
通过rewrite可以实现域名间的跳转，常见的跳转类型有301、302。
永久重定向和临时重定向的区分是为爬取搜索引擎而设置的。如果状态码是301，表示网页地址永久改变，搜索引擎会将旧页面的地址替换成新页面的地址，用户在搜索引擎搜索网站时，就不会再去旧地址了。
如果状态码是302，表示临时重定向，搜索引擎会保留旧页面的地址，因为它认为跳转只是暂时的。当用户使用搜索引擎搜索网站时，会首先进入旧地址然后再被跳转到302指定的新地址。
301和302的跳转并不适合用于POST请求，如果POST请求被跳转的话，会先被转化为GET请求，且请求体的内容会丢失，为此HTTP 1.1提供了新的跳转状态码307和308。
状态码307的意义和302 一样，都是临时重定向；而308和301 一样，都是永久重定向。但如果要求在跳转过程中保持客户端的请求方法不变，需要使用return指令，示例如下：
指令：return
语法：return code [text];
其中code是状态码。return指令会立即返回一个HTTP状态码给客户端，并附加一个文本信息到响应体中，因为此方式缺少Default_Type 响应头，所以当使用浏览器打开时无法直接展示文本信息，而会将文本下载到本地。
return指令用法示例如下。
· return code URL;支持301、302、303、307和308跳转。
· return URL; 默认支持302跳转。
环境：server、location、if
注意： 如果把return和proxy_pass配置为同一级别，那么会直接执行return，而不会执行proxy_pass，同一location块下的其他指令也不会再被执行。
指令：set
语法：set $variable value;
环境：server、location、if
含义：设置指定变量的值，值可以是文本、变量或文本和变量的组合。因为是为当前请求设置的值，所以会在请求结束后被清除掉。
