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配置文件中加入

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

    而不是单独加一句  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" 放到了上面,如果放到下面则不能实现跳转。