`

Nginx 关于 Rewrite 执行顺序详解

 
阅读更多

Rewrite（ URL 重写）指令可以出现在 server{} 下，也可以出现在 location{} 下，它们之间是有区别的！对于出现在 server{} 下的 rewrite 指令，它的执行会在 location 匹配之前；对于出现在 location{} 下的 rewrite 指令，它的执行当然是在 location 匹配之后，但是由于 rewrite 导致 HTTP 请求的 URI 发生了变化，所以 location{} 下的 rewrite 后的 URI 又需要重新匹配 location ，就好比一个新的 HTTP 请求一样（注意由 location{} 内的 rewrite 导致的这样的循环匹配最多不超过 10 次，否则 nginx 会报 500 错误）。总的来说，如果 server{} 和 location{} 下都有 rewrite ，依然是先执行 server{} ，然后进行 location 匹配，如果被匹配的 location{} 之内还有 rewrite 指令，那么继续执行 rewrite ，同时因为 location{} 内的 rewrite 改变了 URI ，那么重写后的结果 URI 需要当做一个新的请求，重新匹配 location （应该也包括重新执行 server{} 下的 rewrite 吧）。

Last 与 break flag 的区别

关于 last flag 和 break flag 的区别，官方文档的描述是：“ last - completes processing of rewrite directives, after which searches for corresponding URI and location ”和“ break - completes processing of rewrite directives ”，都有“不让继续执行后面的 rewrite 指令”的含义，但是两者的区别并没有展开。

这里我用实验来告诉大家区别。实验准备：

1、  安装 nginx ；（如果对安装和 location 不了解的，请参考： http://eyesmore.iteye.com/blog/1141660 ）

 

2、  在 nginx 安装目录的 html 子目录下创建 4 个文件，分别叫： aaa.html ， bbb.html ， ccc.html 和 ddd.html ，文件内容分别是各自的文件名（例 aaa.html 文件内容不妨写 aaa html file ）。

3、  Nginx 配置文件初始化是：

 

error_log  logs/error.log info;  #URL 重写模块的日志会写入此文件

 

   server {

        listen       9090;

        server_name  localhost;

        root html;

        rewrite_log on;   # 打开 URL 重写模块的日志开关，以便写入 error_log

   

        location  /aaa.html {

            rewrite "^/aaa\.html$"  /bbb.html;

            rewrite "^/bbb\.html$"  /ddd.html;

        }  

   

        location  /bbb.html {

            rewrite "^/bbb\.html$" /ccc.html;

        }  

}

上述配置注意两点： 1 、打开 rewrite 模块的日志开关，以便 rewrite 执行日志写入 error_log （注： rewrite 日志写入 error_log 的级别是 notice ，所以要注意 error_log 日志级别，此处用 info ）； 2 、定义了两个 location ，分别是 /aaa.html 和 /bbb.html ，但是在 /aaa.html 中，把 /aaa.html 重写成 /bbb.html ，接着又把 /bbb.html 重写成 /ddd.html ；在 /bbb.html 中，把 /bbb.html 重写成 /ccc.html 。

 

[ 测试 1] 没有 last 和 break 标记时：请求 aaa.html

[root@web108 ~]# curl http://localhost:9090/aaa.html

ddd html file

[root@web108 ~]#

Error_log 的日志内容：

2011/08/07 22:13:23 [notice] 9066#0: *85 "^/aaa\.html$" matches "/aaa.html" , client: 127.0.0.1, server: localhost, request: "GET /aaa.html HTTP/1.1", host: "localhost:9090"

2011/08/07 22:13:23 [notice] 9066#0: *85 rewritten data: "/bbb.html" , args: "", client: 127.0.0.1, server: localhost, request: "GET /aaa.html HTTP/1.1", host: "localhost:9090"

2011/08/07 22:13:23 [notice] 9066#0: *85 "^/bbb\.html$" matches "/bbb.html" , client: 127.0.0.1, server: localhost, request: "GET /aaa.html HTTP/1.1", host: "localhost:9090"

2011/08/07 22:13:23 [notice] 9066#0: *85 rewritten data: "/ddd.html" , args: "", client: 127.0.0.1, server: localhost, request: "GET /aaa.html HTTP/1.1", host: "localhost:9090"

2011/08/07 22:13:23 [info] 9066#0: *85 client 127.0.0.1 closed keepalive connection

 

URL 重写模块的日志告诉我们：对于一个 HTTP 请求“ GET /aaa.html ”，重写过程是：先 /aaa.html 被重写为 /bbb.html ；然后 rewritten data: /bbb.html ，继续执行后面的 rewrite 指令，进而被重写为 /ddd.html ，然后 rewrittern data: /ddd.html 后面没有重写了（其实此时 /ddd.html 需要再次重新匹配 location 的，只是日志没有体现出来，接下来的测试 2 会体现这点），于是输出 /ddd.html 的内容。

 

[ 测试 2] 使用 last 标记时：请求 aaa.html

将上述 location /aaa.html {} 修改成：

location  /aaa.html {

       rewrite "^/aaa\.html$"  /bbb.html   last ;

      rewrite "^/bbb\.html$"  /ddd.html;

}  

 

测试结果：

[root@web108 ~]# curl http://localhost:9090/aaa.html

ccc html file

[root@web108 ~]#

 

Error_log 日志：

2011/08/07 22:24:31 [notice] 18569#0: *86 "^/aaa\.html$" matches "/aaa.html" , client: 127.0.0.1, server: localhost, request: "GET /aaa.html HTTP/1.1", host: "localhost:9090"

2011/08/07 22:24:31 [notice] 18569#0: *86 rewritten data: "/bbb.html" , args: "", client: 127.0.0.1, server: localhost, request: "GET /aaa.html HTTP/1.1", host: "localhost:9090"

2011/08/07 22:24:31 [notice] 18569#0: *86 "^/bbb\.html$" matches "/bbb.html" , client: 127.0.0.1, server: localhost, request: "GET /aaa.html HTTP/1.1", host: "localhost:9090"

2011/08/07 22:24:31 [notice] 18569#0: *86 rewritten data: "/ccc.html" , args: "", client: 127.0.0.1, server: localhost, request: "GET /aaa.html HTTP/1.1", host: "localhost:9090"

2011/08/07 22:24:31 [info] 18569#0: *86 client 127.0.0.1 closed keepalive connection

 

不知道读者看到 GET /aaa.html 显示的结果“ ccc html file ”会不会惊讶：“为什么结果不是 bbb html file ”。下面解释下整个过程：首先 /aaa.html 匹配了 location /aaa.html {} ，于是执行 rewrite "^/aaa\.html$"  /bbb.html last ，把 /aaa.html 重写为 /bbb.html ，同时由于 last flag 的使用，后面的 rewrite 指令（指的是 rewrite "^/bbb\.html$"  /ddd.html ）不会被执行。似乎此时应该输出“ bbb html file ”才对，但是我们看看 nginx 官方解释：“ last - completes processing of rewrite directives, after which searches for corresponding URI and location ”意思是说 last 不再匹配后面的 rewrite 指令，但是紧接着需要对重写后的 URI 重新匹配 location 。让我们再看看官方的“ If the directives of this module are given at the server level, then they are carried out before the location of the request is determined. If in that selected location there are further rewrite directives, then they also are carried out. If the URI changed as a result of the execution of directives inside location, then location is again determined for the new URI. This cycle can be repeated up to 10 times, after which Nginx returns a 500 error. ”因此，重新匹配的时候，匹配到了新的 location /bbb.html {} ，执行“ rewrite "^/bbb\.html$" /ccc.html ”，最后的内容是“ ccc html file ”。

 

[ 测试 3] 使用 break 标记时：请求 aaa.html

将上述 location /aaa.html {} 修改成使用 break 标记：

location  /aaa.html {

      rewrite "^/aaa\.html$"  /bbb.html  break ;

      rewrite "^/bbb\.html$"  /ddd.html;

}  

测试结果：

[root@web108 ~]# curl http://localhost:9090/aaa.html

bbb html file

[root@web108 ~]#

 

日志结果：

2011/08/07 22:37:49 [notice] 21069#0: *89 "^/aaa\.html$" matches "/aaa.html" , client: 127.0.0.1, server: localhost, request: "GET /aaa.html HTTP/1.1", host: "localhost:9090"

2011/08/07 22:37:49 [notice] 21069#0: *89 rewritten data: "/bbb.html" , args: "", client: 127.0.0.1, server: localhost, request: "GET /aaa.html HTTP/1.1", host: "localhost:9090"

2011/08/07 22:37:49 [info] 21069#0: *89 client 127.0.0.1 closed keepalive connection

 

我想这个结果不用多做解释了，充分体现了 break 和 last 的区别：“ last - completes processing of rewrite directives, after which searches for corresponding URI and location ”和“ break - completes processing of rewrite directives ”。 Break 和 last 都能阻止继续执行后面的 rewrite 指令，但是 last 如果在 location 下用的话，对于重写后的 URI 会重新匹配 location ，但是 break 则不会重新匹配 location 。简单的说， break 终止的力度比 last 更加彻底（为了记忆的方便，我们可以把重新后的 URI 重新匹配 location 理解为“ URI 匹配 location 的循环语句的下一次迭代”，高级程序设计里面 break 一般用做退出循环，所以 break 不仅终止继续执行 rewrite ，而且退出 URI 重新匹配 location 的循环迭代）。

 

 

 

 

Nginx 关于 Rewrite 的迭代 第二篇

例题 1

配置：

error_log  logs/error.log info;

 

server {

        listen       9090;

        server_name  localhost;

        root html;

        rewrite_log on;

 

        rewrite "^/aaa\.html$"  /bbb.html;

 

        location  /ccc.html {

            rewrite "^/ccc\.html$"  /eee.html;

        }

 

        location  /bbb.html {

            rewrite "^/bbb\.html$" /ccc.html;

            rewrite "^/ccc\.html$" /ddd.html;

        }  

}   

结果：

[root@web108 ~]# curl http://localhost:9090/aaa.html

ddd html file

[root@web108 ~]#

 

日志：

2011/08/08 10:05:41 [notice] 31592#0: *90 "^/aaa\.html$" matches "/aaa.html" , client: 127.0.0.1, server: localhost, request: "GET /aaa.html HTTP/1.1", host: "localhost:9090"

2011/08/08 10:05:41 [notice] 31592#0: *90 rewritten data: "/bbb.html" , args: "", client: 127.0.0.1, server: localhost, request: "GET /aaa.html HTTP/1.1", host: "localhost:9090"

2011/08/08 10:05:41 [notice] 31592#0: *90 "^/bbb\.html$" matches "/bbb.html" , client: 127.0.0.1, server: localhost, request: "GET /aaa.html HTTP/1.1", host: "localhost:9090"

2011/08/08 10:05:41 [notice] 31592#0: *90 rewritten data: "/ccc.html" , args: "", client: 127.0.0.1, server: localhost, request: "GET /aaa.html HTTP/1.1", host: "localhost:9090"

2011/08/08 10:05:41 [notice] 31592#0: *90 "^/ccc\.html$" matches "/ccc.html" , client: 127.0.0.1, server: localhost, request: "GET /aaa.html HTTP/1.1", host: "localhost:9090"

2011/08/08 10:05:41 [notice] 31592#0: *90 rewritten data: "/ddd.html" , args: "", client: 127.0.0.1, server: localhost, request: "GET /aaa.html HTTP/1.1", host: "localhost:9090"

2011/08/08 10:05:41 [notice] 31592#0: *90 "^/aaa\.html$" does not match "/ddd.html" , client: 127.0.0.1, server: localhost, request: "GET /aaa.html HTTP/1.1", host: "localhost:9090"

2011/08/08 10:05:41 [info] 31592#0: *90 client 127.0.0.1 closed keepalive connection

 

解释：

GET /aaa.html 请求，首先执行 server 级的 rewrite 指令，被重写为 /bbb.html ，然后匹配到 location /bbb.html {} ，接着执行 location 级的 rewrite 指令，先重写为 /ccc.html ，再重写为 /ddd.html ；由于 URI 被 location 级的 rewrite 指令重写了，因此需要重新进行 location 的匹配，相当于重写后的 URI 被当做一个新的请求，会重新执行 server 级的 rewrite ，然后重新匹配 location ，日志“ 2011/08/08 10:05:41 [notice] 31592#0: *90 "^/aaa\.html$" does not match "/ddd.html" , client: 127.0.0.1, server: localhost, request: "GET /aaa.html HTTP/1.1", host: "localhost:9090" ”体现了重新匹配 location 的流程。

 

例题 2

配置：

error_log  logs/error.log info;

 

server {

        listen       9090;

        server_name  localhost;

        root html;

        rewrite_log on;

 

        rewrite "^/aaa\.html$"  /bbb.html;

                   rewrite "^/ccc\.html$"  /ddd.html;

        

        location  /bbb.html {

            rewrite "^/bbb\.html$" /ccc.html;

        }  

                   location  /ddd.html {

             rewrite "^/ddd\.html$" /eee.html;

        }

}   

结果：

[root@web108 ~]# curl http://localhost:9090/aaa.html

eee html file

[root@web108 ~]#

 

日志：

2011/08/08 10:21:00 [notice] 2218#0: *91 "^/aaa\.html$" matches "/aaa.html" , client: 127.0.0.1, server: localhost, request: "GET /aaa.html HTTP/1.1", host: "localhost:9090"

2011/08/08 10:21:00 [notice] 2218#0: *91 rewritten data: "/bbb.html" , args: "", client: 127.0.0.1, server: localhost, request: "GET /aaa.html HTTP/1.1", host: "localhost:9090"

2011/08/08 10:21:00 [notice] 2218#0: *91 "^/ccc\.html$" does not match "/bbb.html" , client: 127.0.0.1, server: localhost, request: "GET /aaa.html HTTP/1.1", host: "localhost:9090"

2011/08/08 10:21:00 [notice] 2218#0: *91 "^/bbb\.html$" matches "/bbb.html" , client: 127.0.0.1, server: localhost, request: "GET /aaa.html HTTP/1.1", host: "localhost:9090"

2011/08/08 10:21:00 [notice] 2218#0: *91 rewritten data: "/ccc.html" , args: "", client: 127.0.0.1, server: localhost, request: "GET /aaa.html HTTP/1.1", host: "localhost:9090"

2011/08/08 10:21:00 [notice] 2218#0: *91 "^/aaa\.html$" does not match "/ccc.html" , client: 127.0.0.1, server: localhost, request: "GET /aaa.html HTTP/1.1", host: "localhost:9090"

2011/08/08 10:21:00 [notice] 2218#0: *91 "^/ccc\.html$" matches "/ccc.html" , client: 127.0.0.1, server: localhost, request: "GET /aaa.html HTTP/1.1", host: "localhost:9090"

2011/08/08 10:21:00 [notice] 2218#0: *91 rewritten data: "/ddd.html" , args: "", client: 127.0.0.1, server: localhost, request: "GET /aaa.html HTTP/1.1", host: "localhost:9090"

2011/08/08 10:21:00 [notice] 2218#0: *91 "^/ddd\.html$" matches "/ddd.html" , client: 127.0.0.1, server: localhost, request: "GET /aaa.html HTTP/1.1", host: "localhost:9090"

2011/08/08 10:21:00 [notice] 2218#0: *91 rewritten data: "/eee.html" , args: "", client: 127.0.0.1, server: localhost, request: "GET /aaa.html HTTP/1.1", host: "localhost:9090"

2011/08/08 10:21:00 [notice] 2218#0: *91 "^/aaa\.html$" does not match "/eee.html" , client: 127.0.0.1, server: localhost, request: "GET /aaa.html HTTP/1.1", host: "localhost:9090"

2011/08/08 10:21:00 [notice] 2218#0: *91 "^/ccc\.html$" does not match "/eee.html" , client: 127.0.0.1, server: localhost, request: "GET /aaa.html HTTP/1.1", host: "localhost:9090"

2011/08/08 10:21:00 [info] 2218#0: *91 client 127.0.0.1 closed keepalive connection

 

解释：

第一次迭代 location 匹配

GET /aaa.html ，首先执行 server 级的重写，“ rewrite "^/aaa\.html$"  /bbb.html ”把 /aaa.html 重写为 /bbb.html ，但 /bbb.html 没匹配上“ rewrite "^/ccc\.html$"  /ddd.html ”，最终保留 /bbb.html ；接着，匹配 location /bbb.html {} ，执行 location 级的 rewrite 指令，把 /bbb.html 重写为 /ccc.html ，由于 URI 被 location 级 rewrite 重写，因此需要重新迭代 location 匹配。

 

第二次迭代 location 匹配

对于第一次迭代结果 /ccc.html ，首先依然是执行 server 级的 rewrite 指令，“ rewrite "^/aaa\.html$"  /bbb.html; ”跟 /ccc.html 不匹配，但“ rewrite "^/ccc\.html$"  /ddd.html; ”把 /ccc.html 重写为 /ddd.html ； server 级 rewrite 执行完后，接着 location 匹配， /ddd.html 匹配到 location /ddd.html {} ，执行 location 级的 rewrite 指令，把 /ddd.html 重写为 /eee.html 。同样由于 URI 被 location 级的 rewrite 指令重写，于是需要重新迭代 location 匹配。

 

第三次迭代 location 匹配

对于第二次迭代结果 /eee.html ，首先依然执行 server 级的 rewrite 指令，“ rewrite "^/aaa\.html$"  /bbb.html; ”和“ rewrite "^/ccc\.html$"  /ddd.html; ”，只不过它们都没匹配上 /eee.html ，接着 /eee.html 进行 location 匹配，也没有，最终结果是 /eee.html ，返回“ eee html file ”页面。

 

 

最后说明下，如果把上述配置修改成server级rewrite和location的编辑顺序调整：

server {
        listen       9090;
        server_name  localhost;
        root html;
        rewrite_log on;

               
        location  /bbb.html {
            rewrite "^/bbb\.html$" /ccc.html;
        }   
        location  /ddd.html {
            rewrite "^/ddd\.html$" /eee.html;
        }

 

        rewrite "^/aaa\.html$"  /bbb.html;
        rewrite "^/ccc\.html$"  /ddd.html;
}

结果是不会受影响的，也就是说location匹配迭代总是先执行server级rewrite，再进行location匹配，再执行location级的rewrite，如果URI因location级rewrite指令重写，则需要进行下一次迭代。但总的迭代次数不超过10次，否则nginx报500错误。

 

简单伪代码描述下rewrite执行过程：

 

boolean match_finish = false;
int match_count = 0;
while(!match_finish && match_count < 10) {
        match_count ++;
    （1）按编辑顺序执行server级的rewrite指令；
    （2）按重写后的URI匹配location；
    （3）
        String uri_before_location = uri;
        按编辑顺序执行location级的rewrite指令；
        String uri_after_location = rewrite(uri);
        if(uri_before_location != uri_after_location) {
            match_finish = false;            
        } else {
            match_finish = true;
        }
        if(location rewrite has last flag) {
            continue;//表示不执行后面的rewrite，直接进入下一次迭代
        }
        if(location rewrite has break flag) {
            break;//表示不执行后面的rewrite，并退出循环迭代
        }
}
if(match_count <= 10) {
    return HTTP_200;
} else {
    return HTTP_500;
}

分享到：
| 用sublime替换整个文件夹下多个文件某个字 ...
评论
发表评论

您还没有登录,请您登录后再发表评论

相关推荐

    Nginx关于Rewrite执行顺序详解.docx

    这篇文档将深入解析Nginx中Rewrite模块的执行顺序及其背后的逻辑。 一、Rewrite模块简介 Nginx的Rewrite模块通过配置指令`rewrite`来处理URL重写。一个基本的`rewrite`指令由正则表达式、替换字符串和可选的标志...

    Nginx关于location的匹配规则详解.docx

    **Nginx中的Location匹配规则详解** 在Nginx服务器配置中，`location`指令是核心部分之一，用于处理HTTP请求。它根据指定的规则来匹配URL，从而决定如何处理客户端的请求。本文将深入探讨Nginx `location`的匹配...

    nginx脚本引擎与rewrite设计原理(二)

    ### Nginx脚本引擎与Rewrite设计原理深入解析 #### 一、Set语句的解析与处理 在深入探讨Nginx脚本引擎与Rewrite设计原理时，我们聚焦于`set`与`rewrite`指令的处理机制，这两者在Nginx的配置文件中极为常见，尤其...

    linux下安装Nginx以及配置文件详解

    ### Linux 下 Nginx 的安装与配置详解 #### 一、Nginx 概述 Nginx（发音为 "engine X"）是一款开源的 Web 服务器，它以高性能著称，尤其在处理高并发连接方面表现优异。Nginx 除了作为 HTTP 服务器外，还可以作为...

    Nginx Rewrite使用场景及代码案例详解

    - `[flag]`：可选的flag标志，用于定义rewrite规则的执行行为。 可选的flag标志包括： - `last`：停止处理后续的rewrite规则，跳出当前location作用域，开始搜索与更改后的URI匹配的location，URL地址不变。 - `...

    详解nginx配置location总结及rewrite规则写法

    location规则和rewrite规则都会按照配置文件中的顺序被检查，一旦匹配，相关的location块内的指令将被执行，直到遇到一个break或者last标记。 在实际应用中，以下配置建议可作为一个参考： - 第一个匹配规则通常...

    详解nginx中location、rewrite用法总结

    **Nginx中的Location与Rewrite用法详解** 在Nginx服务器配置中，`location`和`rewrite`是两个非常关键的指令，用于处理HTTP请求的路由和URL重写。理解并熟练运用这两个指令对于优化网站性能和提供灵活的URL管理至关...

    nginx 开启 pathinfo的过程详解

    Nginx开启PathInfo的过程主要有两个步骤：一是通过URL重写使Nginx能够解析URL中的PathInfo部分；二是对location块进行配置，以便Nginx能够将PathInfo传递给后端脚本。接下来，我将详细介绍如何在Nginx上开启PathInfo...

    nginx脚本引擎与rewrite设计原理(三)

    ### Nginx脚本引擎与Rewrite设计原理详解 #### 一、引言 Nginx作为一款高性能的Web服务器及反向代理服务器，在互联网领域得到了广泛应用。其强大的功能不仅体现在高并发处理能力上，还在于灵活的配置选项以及丰富的...

    nginx示例代码以及中文配置详解

    4. **指令顺序**：配置文件中的指令执行顺序对结果有影响，一般是从上到下依次解析。 **核心配置模块** 1. **http模块**：定义全局设置，如日志格式、文件路径等。 2. **server模块**：定义一个监听的网络端口，...

    使用OneinStack配置Nginx反向代理、多网站配置、多域名配置

    《使用OneinStack配置Nginx反向代理与多网站多域名配置详解》 Nginx作为一款高性能的HTTP和反向代理服务器，常用于网站的负载均衡和内容分发，其灵活性和稳定性深受运维人员喜爱。在OneinStack框架下配置Nginx，...

    详解常用的nginx rewrite重写规则

    Nginx 的 `rewrite` 指令是一个强大的URL重写工具，它允许你通过正则表达式和标志位来转换请求的URL，从而实现URL美化、路由分发等多种功能。下面将详细介绍这些常见的 `rewrite` 重写规则及其应用场景。 1. **执行...

    nginx 安装配置详解

    在本篇文章中，我们将详细介绍Nginx的安装过程，核心模块的介绍，配置文件的解析，以及其在实际使用中的常见场景。 **一、Nginx安装** 1. **Ubuntu/Debian系统**：使用apt-get命令进行安装。 ```bash sudo apt-...

    nginx 伪静态 重定向

    Nginx重定向规则详解 Nginx的`rewrite`指令，类似于Apache的`RewriteRule`，但更加强大且灵活，支持在`server`、`location`以及`if`语句中使用。其基本格式为： ``` rewrite 正则表达式 替换目标 flag标记; ``` ...

    nginx rewrite重写规则与防盗链配置方法教程详解

    合理配置rewrite规则，不仅可以提升用户体验，还能提高服务器的运行效率和资源利用率。同时，配置适当的防盗链机制可以帮助网站保护自身的数据资源，避免不必要的流量损失和带宽浪费。对于有兴趣深入了解Nginx ...

    nginx1.24.0,包含GCC/zlib/prce依赖

    GCC 是一套开源的编译器集合，用于将源代码编译为可执行程序。在 Nginx 的构建过程中，GCC 用于将 C/C++ 语言的源代码编译为二进制文件。GCC 提供了优化选项，可以生成针对特定硬件平台性能最佳的代码，从而提升 ...

    Nginx 反向代理、负载均衡、页面缓存、URL重写及读写分离详解

    ### Nginx 反向代理、负载均衡、页面缓存、URL重写及读写分离详解 #### 一、前言 Nginx是一款广泛使用的高性能HTTP和反向代理Web服务器，也是邮件代理服务器，并具有IMAP/POP3/SMTP服务。Nginx以其稳定性、丰富的...

Magicbox
Global site tag (gtag.js) - Google Analytics