nginx里的break和last

break和last是nginx的rewrite_module里的指令，tengine翻译的文档里对这两个的指令解释是：

 

last
停止执行当前这一轮的ngx_http_rewrite_module指令集，然后查找匹配改变后URI的新location；
break
停止执行当前这一轮的ngx_http_rewrite_module指令集；

 

 

就我所知，这两个指令都可以用来实现内部重定向（internal redirect），我经常有疑问，这两个指令具体的区别是什么呢？昨天总算弄清楚了一点，请往下看：

 

我定义了一个虚拟主机 "nigel.zeng.me" ：

 

server {
listen 80 default_server;
server_name nigel.zeng.me;
root www;
access_log logs/nigel.log main;

location /foo/ {
    rewrite ^/foo/(.*) /test/$1 break;
          echo "break keyword";
}

location /bar/ {
      rewrite ^/bar/(.*) /test/$1 last;
          echo "last keyword";
}

location /test/ {
       valid_referers none server_names ~nigel\.zeng\.me;
              if ($invalid_referer) {
                        return 403;
                  }
}
}

 

里面定义了的两个location，第一个用来处理 http://nigel.zeng.me/foo/*** 的情况，使用break来做内部重定向，把http://nigel.zeng.me/foo/***  重写为 http://nigel.zeng.me/test/***；

第二个location用来处理http://nigel.zeng.me/bar/*** 的情况，使用last来做内部重定向，也是重定向到http://nigel.zeng.me/test/***。

echo指令是agentzh所编写的echo-nginx-module第三方模块里带的。

 

这里准备的两个url是 http://nigel.zeng.me/foo/index.html 和 http://nigel.zeng.me/bar/index.html。

内部重定向后的页面 http://nigel.zeng.me/test/index.html 如下：

按照tengine的中文文档里介绍的，break指令会停止去匹配新的location，而last指令则会去查找匹配改变后URI的新location，那么按照上面的配置，访问第一个URL “http://nigel.zeng.me/foo/index.html“ 会返回 "break keyword" 字段，而访问 ”http://nigel.zeng.me/bar/index.html“ 则会返回 http://nigel.zeng.me/test/index.html 的结果。

 

OK，看看测试结果：

访问第一个URL “http://nigel.zeng.me/foo/index.html“：

访问第二个URL ”http://nigel.zeng.me/bar/index.html“：

所以从测试结果可以得出以下结论：

1、rewrite后接break指令，完成rewrite之后会执行完当前的location（或者是if）指令里的其他内容（停止执行当前这一轮的ngx_http_rewrite_module指令集），然后不进行新URL的重新匹配。

2、rewrite后接last指令，在完成rewrite之后停止执行当前这一轮的ngx_http_rewrite_module指令集已经后续的指令，进而为新的URL寻找location匹配。

 

结果仅供参考。

 

-----EOF------

 

have fun.

 

-- nigelzeng