总结: rewrite 可以在 server location 块, 正则比配的时候才重写,所以多条 rewrite 顺序靠前且匹配的优先执行。
break跳出rewrite阶段,不会在匹配,进入输出阶段。 last 类似重新发起请求,所以会重新进行匹配。

nginx 的官方注释是这样的:

last stops processing the current set of ngx_http_rewrite_module directives followed by a search for a new location matching the changed URI;

break

stops processing the current set of ngx_http_rewrite_module directives;

nginx运行流程

我们知道nginx运行分十一个执行阶段,上面说提到的ngx_http_rewrite_mode,可以理解为其中一个阶段-rewrite阶段。

  1. typedef enum {
  2. NGX_HTTP_POST_READ_PHASE = 0,
  3. NGX_HTTP_SERVER_REWRITE_PHASE,
  4. NGX_HTTP_FIND_CONFIG_PHASE,
  5. NGX_HTTP_REWRITE_PHASE, //rewrite阶段在这里
  6. NGX_HTTP_POST_REWRITE_PHASE,
  7. NGX_HTTP_PREACCESS_PHASE,
  8. NGX_HTTP_ACCESS_PHASE,
  9. NGX_HTTP_POST_ACCESS_PHASE,
  10. NGX_HTTP_TRY_FILES_PHASE,
  11. NGX_HTTP_CONTENT_PHASE,
  12. NGX_HTTP_LOG_PHASE
  13. } ngx_http_phases;

last与break的区别

last: 停止当前这个请求,并根据rewrite匹配的规则重新发起一个请求。新请求又从第一阶段开始执行…
break:相对last,break并不会重新发起一个请求,只是跳过当前的rewrite阶段,并执行本请求后续的执行阶段…

我们来看一个例子:

  1. server {
  2. listen 80 default_server;
  3. server_name dcshi.com;
  4. root www;
  5. location /break/ {
  6. rewrite ^/break/(.*) /test/$1 break;
  7. echo "break page";
  8. }
  9. location /last/ {
  10. rewrite ^/last/(.*) /test/$1 last;
  11. echo "last page";
  12. }
  13. location /test/ {
  14. echo "test page";
  15. }
  16. }

请求:http://dcshi.com/break/*
输出: break page
分析:正如上面讨论所说,break是跳过当前请求的rewrite阶段,并继续执行本请求的其他阶段,很明显,对于/break 对应的content阶段的输出为 echo “break page”; (content阶段,可以简单理解为产生数据输出的阶段,如返回静态页面内容也是在content阶段;echo指令也是运行在content阶段,一般情况下content阶段只能对应一个输出指令,如同一个location配置两个echo,最终只会有一个echo指令被执行);当然如果你把/break/里的echo 指令注释,然后再次访问/break/xx会报404,这也跟我们预期一样:虽然/break/xx被重定向到/test/xx,但是break指令不会重新开启一个新的请求继续匹配,所以nginx是不会匹配到下面的/test/这个location;在echo指令被注释的情况下,/break/ 这location里只能执行nginx默认的content指令,即尝试找/test/xx这个html页面并输出起内容,事实上,这个页面不存在,所以会报404的错误。

请求: http://dcshi.com/last/*
输出: test page
分析: last与break最大的不同是,last会重新发起一个新请求,并重新匹配location,所以对于/last,重新匹配请求以后会匹配到/test/,所以最终对应的content阶段的输出是test page;

假设你对nginx的运行阶段有一个大概的理解,对理解last与break就没有问题了。

  1. location ~ ^/testtest/ {
  2. default_type text/html;
  3. echo 111;
  4. }
  5. rewrite ^/testtest/ /test.php last;

访问 /testtest/的时候,输出的值是/test.php的内容,显然,重写到rewrite上了,交换rewrite和location位置,执行结果不变,说明这个和位置无关。