Nginx的rewrite应用（转自猿课阿铭老师论坛分享）

本文主要是介绍Nginx的rewrite应用（转自猿课阿铭老师论坛分享），希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

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;}

nginx $document_uri 参数使用

$document_uri 表示访问的url

现在我的需求是，访问 www.abc.com 请求到 www.abc.com/abc/

在nginx配置文件中加入

if ($document_uri !~ 'abc')
{
rewrite ^/(.*)$ http://www.abc.com/abc/$1 permanent；
}

而不是单独加一句 rewrite ^/(.*)$ http://www.abc.com/abc/$1 permanent;
如果只加rewrite 规则，而不限定条件，那么会造成死循环。会访问到 http://www.abc.com/abc/abc/abc/abc/....

nginx的301与302如何配置

首先看一个完整代码示例，关于nginx 301 302跳转的。

301跳转设置：

server {
listen 80;
server_name 123.com;
rewrite ^/(.*) http://456.com/$1 permanent;
access_log off;
}

302跳转设置：

server {
listen 80;
server_name 123.com;
rewrite ^/(.*) http://456.com/$1 redirect;
access_log off;
}

在看下关于nginx 301 302跳转的详细说明文档

server {
server_name test.com;
rewrite ^/(.*) http://www.test1.com/$1 permanent;
}

last – 基本上都用这个Flag。
break – 中止Rewirte，不在继续匹配
redirect – 返回临时重定向的HTTP状态302
permanent – 返回永久重定向的HTTP状态301

Nginx的重定向用到了Nginx的HttpRewriteModule，下面简单解释以下如何使用的方法：
rewrite命令

nginx的rewrite相当于apache的rewriterule(大多数情况下可以把原有apache的rewrite规则加上引号就可以直接使用)，它可以用在server,location 和IF条件判断块中,命令格式如下：
rewrite 正则表达式替换目标 flag标记
flag标记可以用以下几种格式：
last – 基本上都用这个Flag。
break – 中止Rewirte，不在继续匹配
redirect – 返回临时重定向的HTTP状态302
permanent – 返回永久重定向的HTTP状态301

特别注意：

last和break用来实现URL重写，浏览器地址栏的URL地址不变，但是在服务器端访问的路径发生了变化；

redirect和permanent用来实现URL跳转，浏览器地址栏会显示跳转后的URL地址；

例如下面这段设定nginx将某个目录下面的文件重定向到另一个目录,$2对应第二个括号(.*)中对应的字符串：
location /download/ {
rewrite ^(/download/.*)/m/(.*)\..*$ $1/nginx-rewrite/$2.gz break;
}
nginx重定向的IF条件判断

在server和location两种情况下可以使用nginx的IF条件判断，条件可以为以下几种：
正则表达式

如：
匹配判断
~ 为区分大小写匹配; !~为区分大小写不匹配
~* 为不区分大小写匹配；!~为不区分大小写不匹配
例如下面设定nginx在用户使用ie的使用重定向到/nginx-ie目录下：
if ($http_user_agent ~ MSIE) {
rewrite ^(.*)$ /nginx-ie/$1 break;
}
文件和目录判断
-f和!-f判断是否存在文件
-d和!-d判断是否存在目录
-e和!-e判断是否存在文件或目录
-x和!-x判断文件是否可执行
例如下面设定nginx在文件和目录不存在的时候重定向：
if (!-e $request_filename) {
proxy_pass http://127.0.0.1;
}
return

返回http代码，例如设置nginx防盗链：
location ~* \.(gif|jpg|png|swf|flv)$ {
valid_referers none blocked www.test.com www.test1.com;
if ($invalid_referer) {
return 404;
}
}

nginx rewrite不支持if 嵌套也不支持逻辑或和逻辑并

如题，apache的rewrite是支持或者的，用个OR就可以，如果不加OR，多个RewriteCond 罗列累加就是并且的意思。然后nginx的rewrite就没有这么好了。那么如何去实现这样复杂的功能呢？这就用到了标记功能。

现在出一个简单的需求：要求访问uri以 /abc/开头的请求，并且user_agent带有ie6或者firefox关键词的请求需要禁止访问。
实现方法为：
      set $rule 0;
            if ($document_uri ~ '^/abc')
            {
                     set $rule "${rule}1";
            }
            if ($http_user_agent ~* 'ie6|firefox')
            {
                     set $rule "${rule}2";
            }
            if ($rule = "012")
            {
                     deny all;
            }
这样就可以实现了。
然后在我实践过程中，发现一个问题，就是如果定义超过3条rule，当条件中包含两条和两条以上的规则同时存在是，需要把两条规则的条件写到第4条规则前面。
例如，有一个这样的需求：实现rewrite的总前提是，所有请求必须以^/abc 目录为开头。其余规则如下：
1. user_agent 包含 'ipone' 或者'ipad'  或者'ipod' 的请求需要把 *htm 转发为 *html;
2. user_agent 不包含 'ipone' 或者'ipad'  或者'ipod' 并且user_agent 包含'ucweb'的请求需要把*htm 转发为 *html;
3. user_agent 不包含 'ipone' 或者'ipad'  或者'ipod' 并且user_agent 不包含'ucweb'的请求需要把*html 转发为 *htm;
规则语句为：
   set $rule 2;
      if ($document_uri ~* '^/abc')
      {
         set $rule "${rule}1";
      }
      if ($http_user_agent ~* 'ipad|iphone|ipod')
      {
         set $rule "${rule}2";
      }
      if ($rule = "212")
      {
         rewrite ^(.*)\.htm$ $1\.html redirect;
      }
      if ($http_user_agent !~* 'ipad|iphone|ipod')
      {
         set $rule "${rule}3";
      }
      if ($http_user_agent !~* 'ucweb')
      {
         set $rule "${rule}4";
      }
      if ($http_user_agent ~* 'ucweb')
      {
         set $rule "${rule}5";
      }
      if ($rule = "2134")
      {
         rewrite ^(.*)\.html$ $1\.htm redirect;
      }
      if ($rule = "2135")
      {
         rewrite ^(.*)\.htm$ $1\.html redirect;
      }
注意，上面规则把 $rule = "212" 放到了上面，如果放到下面则不能实现跳转。