关于 rewrite

rewrite 的一般多用于实现 RUL 地址的重定向。

Nginx 的 rewrite 通过 perl 兼容正则表达式语句进行规则匹配的。

默认配置下，Nginx 会支持 rewrite 的模块。

rewrite 的作用

通过下方案例便能轻松理解 rewrite 的作用。

# 原本访问文章的URL
http://www.mebugs.com/post.php?url=java
# URL太不美观、暴露了我的后端请求地址、暴露了请求参数
# 通过rewrite可以实现如下地址访问，等同于上方地址
http://www.mebugs.com/post_java.html
# 配置规则
# 访问post_开头.html结果地址，重写到post.php?url=中间匹配的字符
rewrite ^/post_(.*).html$  /post.php?url=$1  break;
​

理解作用后，我们可以看下 rewrite 的语法。

rewrite 的语法

rewrite 的语法很简单，分为四部分。

#关键字    正则      替代内容        标记
rewrite    <regex>   <replacement>   [flag];
​

• 关键字：关键字不能改变
• 正则：perl 兼容正则表达式语句进行规则匹配
• 替代内容：将正则匹配的内容替换成 replacement
• 标记：rewrite 支持的 flag 标记

正则

关于正则的规则不需要多说，这一段内容主要用于匹配访问的 URL。

rewrite 中常见的正则规则：

• \：标记后续字符串为特殊字符串或原义字符或一个向后引用，如“\n”匹配一个换行符，而“$”则匹配“$”
• ^：匹配起始位置
• $：匹配结束位置
• .：匹配任何单个字符
• *：匹配前面的字符零次或多次，如 x*能匹配 x、xx、xxx，.*则表示通配
• +：匹配前面的字符一次或多次
• ?：匹配前面的字符零次或一次，"?"等效于"{0,1}"
• (pattern)：非常重要！！！匹配括号内 pattern 并可以在后面获取对应的匹配，常用 $1...$9 属性获取小括号中的匹配内容

rewrite 中的正则还受其所在的 location 影响，因为外部 location 也是可以正则的。

注意：rewrite 可以不配置在 location 下表示全局生效

# 基本规则（所有的URL都会接受rewrite）
location / {
  rewrite ^/post_(.*).html$  /post.php?url=$1  break;
}
# location有规则（只有URL以.html结尾的请求才会进来）
location ~ .*.(html)?$ {
  rewrite ^/post_(.*).html$  /post.php?url=$1  break;
}
# 这是一个错误的规则（不会生效）
# 外部定义了只有/open开始的URL进来，内部定义了匹配/post，所以规则不会生效
location /open {
  rewrite ^/post_(.*).html$  /post.php?url=$1  break;
}
​

替代内容

替代内容实际上就是将前面匹配到的 URL 转换成实际 URL。

需要注意的是，里面是可以接受参数的，接受的内容为正则中圆括号包裹的内容。

# 还是上文的例子
# $1取得是前面规则中(.*)匹配的字符串，比如：/post_java.html时$1就是java
rewrite ^/post_(.*).html$  /post.php?url=$1  break;
# 多参数的写法
# /page_new_1_.html => /page.php?type=new&current=1
rewrite ^/page_([a-z]+)_(d+)_.html$  /page.php?type=$1&current=$2  break;
​

标记[flag]

这是一个可选项，不写默认似乎是 last。

• last：本条规则匹配完成后，继续向下匹配新的 location URI 规则
• break：本条规则匹配完成即终止，不再匹配后面的任何规则
• redirect：返回 302 临时重定向，浏览器地址会显示跳转后的 URL 地址
• permanent：返回 301 永久重定向，浏览器地址栏会显示跳转后的 URL 地址

我们看到 redirect 和 permanent 会发生重定向。

而 last 和 break 用来实现 URL 重写，浏览器地址栏 URL 地址不变。

其他注意点

正则匹配传参部分才需要圆括号

正则中如果只是匹配但不需要传参，则无需用圆括号包裹。

rewrite ^/c_[0-9]+/(.*)$ /comm/$1 break;
# 上方规则仅仅对第二部分进行传参匹配
# 比如：/c_1/go =>/comm/go  /c_1/xx/mo =>/comm/xx/mo
​

引入规则配置文件

rewrite 不一定需要完全在配置文件中配置，可以单独引入。

# REWRITE-START URL重写规则引用,修改后将导致面板设置的伪静态规则失效
include /www/server/rewrite/mebugs.conf;
# REWRITE-END
# 配置文件不一定要.conf，.htaccess 也是可以的
​

活用一些全局变量

配置 rewrite 规则时可以引入一些 Nginx 的全局变量，甚至增加 if 条件判断，可以实现更为复杂的规则配置。

# 如果访问的是mebugs.com的任意子域名才生效如下规则
if ($host ~* (.*)/.mebugs/.com) {
  rewrite ^/page_([a-z]+)_(d+)_.html$  /page.php?type=$1&current=$2 last;
}
# 特定子域名访问子目录
if ($http_host ~ me/.mebugs/.com$) {
  rewrite ^(.*) /me/$1 break;
}
​