Nginx的Rewrite设置及示例

Nginx以其良好的并发性能，目前正在逐渐取代Apache成为大家的Web server首选，但是Nginx目前的中文资料很少，需要大家努力贡献。

下面我介绍一下Nginx的Rewrite模块设置及Wordpress和Discuz的示例。Nginx的Rewrite规则比Apache的简单灵活多了，从下面介绍可见一斑。

首先，Nginx可以用if进行条件匹配，语法规则类似C，举例如下：

if ($http_user_agent ~ MSIE) {
rewrite  ^(.*)$  /msie/$1  break;
}

1、正则表达式匹配，其中：

* ~  为区分大小写匹配
* ~* 为不区分大小写匹配
* !~和!~*分别为区分大小写不匹配及不区分大小写不匹配

2、文件及目录匹配，其中：

* -f和!-f用来判断是否存在文件
* -d和!-d用来判断是否存在目录
* -e和!-e用来判断是否存在文件或目录
* -x和!-x用来判断文件是否可执行

如：

if (!-f $request_filename) {
proxy_pass  http://127.0.0.1;
}

其次，Nginx的Rewrite规则与Apache几乎完全一致，所不同的是最后的flag标记，举例如下：

rewrite ^/feed/$ http://feed.shunz.net last;

flag标记有：

* last 相当于Apache里的[L]标记，表示完成rewrite，不再匹配后面的规则
* break 与last类似
* redirect 返回302临时重定向
* permanent 返回301永久重定向

Wordpress的重定向规则：

if (!-e $request_filename) {
rewrite ^/(index|atom|rsd)\.xml$ http://feed.shunz.net last;
rewrite ^([_0-9a-zA-Z-]+)?(/wp-.*) $2 last;
rewrite ^([_0-9a-zA-Z-]+)?(/.*\.php)$ $2 last;
rewrite ^ /index.php last;
}

Discuz!的重定向规则：

if (!-f $request_filename) {
rewrite ^/archiver/((fid|tid)-[\w\-]+\.html)$   /archiver/index.php?$1 last;
rewrite ^/forum-([0-9]+)-([0-9]+)\.html$   /forumdisplay.php?fid=$1&page=$2 last;
rewrite ^/thread-([0-9]+)-([0-9]+)-([0-9]+)\.html$  /viewthread.php?tid=$1&extra=page%3D$3&page=$2 last;
rewrite ^/space-(username|uid)-(.+)\.html$   /space.php?$1=$2 last;
rewrite ^/tag-(.+)\.html$ /tag.php?name=$1 last;
}

---

打开Nginx的rewrite日志

Nginx如果rewrite写了很多条，很容易发现rewrite写的没问题，可是就是匹配不了，很可能已匹配到其它rewrite中去了。打开rewrite的log，可以清晰的看到其匹配的先后顺序，和那一条匹配了。

方法：

1：在nginx.conf的http段加入如下：

rewrite_log on;

error_log logs/xxxerror.log notice;

注意两点：

1）在nginx.conf的http字段加。

2）注意 error_log的级别是notice，否则不会显示其具体的匹配过程，但需要注意，最好在测试环境下调试，error_log会增长的很快，我们网站20分钟5G多，所以在线上调试完了，尽快关闭！或改成error级别的。