nginx模块 | 易学教程

if指令格式：

if (条件判断) { 具体的rewrite规则 }

条件举例

条件判断语句由Nginx内置变量、逻辑判断符号和目标字符串三部分组成。
其中，内置变量是Nginx固定的非自定义的变量，如，$request_method, $request_uri等。
逻辑判断符号，有=, !=, ~, ~*, !~, !~*
!表示相反的意思，~为匹配符号，它右侧为正则表达式，区分大小写，而~*为不区分大小写匹配。
目标字符串可以是正则表达式，通常不用加引号，但表达式中有特殊符号时，比如空格、花括号、分号等，需要用单引号引起来。

示例1

if ($request_method = POST)  //当请求的方法为POST时，直接返回405状态码
{
    return 405; //在该示例中并未用到rewrite规则，if中支持用return指令。
}


示例2

if ($http_user_agent ~ MSIE) //user_agent带有MSIE字符的请求，直接返回403状态码 { return 403; }

如果想同时限制多个user_agent，还可以写成这样

if ($http_user_agent ~ "MSIE|firefox|spider") { return 403; }


示例3

if(!-f $request_filename) //当请求的文件不存在，将会执行下面的rewrite规则 { rewrite 语句; }


示例4

if($request_uri ~* 'gid=\d{9,12}/') //\d表示数字，{9,12}表示数字出现的次数是9到12次，如gid=123456789/就是符合条件的。 { rewrite 语句; }

rewrite中的break和last

两个指令用法相同，但含义不同，需要放到rewrite规则的末尾，用来控制重写后的链接是否继续被nginx配置执行(主要是rewrite、return指令)。

示例1（连续两条rewrite规则）：
server{
    listen 80; 
    server_name test.com;
    root /tmp/123.com;

    rewrite /1.html /2.html ;
    rewrite /2.html /3.html ;
    
}
当我们请求1.html时，最终访问到的是3.html，两条rewrite规则先后执行。

break和last在location {}外部

格式：rewrite xxxxx  break;

示例2（增加break）：
server{
    listen 80; 
    server_name test.com;
    root /tmp/123.com;

    rewrite /1.html /2.html break;
    rewrite /2.html /3.html;
}
当我们请求1.html时，最终访问到的是2.html
说明break在此示例中，作用是不再执行break以下的rewrite规则。

但，当配置文件中有location时，它还会去执行location{}段的配置（请求要匹配该location）。

示例3（break后面还有location段）：
server{
    listen 80; 
    server_name test.com;
    root /tmp/123.com;

    rewrite /1.html /2.html break;
    rewrite /2.html /3.html;
    location /2.html {
        return 403;
    }
}
当请求1.html时，最终会返回403状态码，说明它去匹配了break后面的location{}配置。

以上2个示例中，可以把break替换为last，它们两者起到的效果一模一样。

当break和last在location{}里面

示例4（什么都不加）：
server{
    listen 80; 
    server_name test.com;
    root /tmp/123.com;
    
    location / {
        rewrite /1.html /2.html;
        rewrite /2.html /3.html;
    }
    location /2.html
    {
        rewrite /2.html /a.html;
    }
    location /3.html
    {
        rewrite /3.html /b.html;
    }
}
当请求/1.html，最终将会访问/b.html，连续执行location /下的两次rewrite，跳转到了/3.html，然后又匹配location /3.html

示例5（增加break）：
server{
    listen 80; 
    server_name test.com;
    root /tmp/123.com;
    
    location / {
        rewrite /1.html /2.html break;
        rewrite /2.html /3.html;
    }
    location /2.html
    {
        rewrite /2.html /a.html;
    }
    location /3.html
    {
        rewrite /3.html /b.html;
    }
}
当请求/1.html，最终会访问/2.html
在location{}内部，遇到break，本location{}内以及后面的所有location{}内的所有指令都不再执行。


示例6（增加last）:
server{
    listen 80; 
    server_name test.com;
    root /tmp/123.com;
    
    location / {
        rewrite /1.html /2.html last;
        rewrite /2.html /3.html;
    }
    location /2.html
    {
        rewrite /2.html /a.html;
    }
    location /3.html
    {
        rewrite /3.html /b.html;
    }
}
当请求/1.html，最终会访问/a.html
在location{}内部，遇到last，本location{}内后续指令不再执行，而重写后的url再次从头开始，从头到尾匹配一遍规则。

结论

当rewrite规则在location{}外，break和last作用一样，遇到break或last后，其后续的rewrite/return语句不再执行。但后续有location{}的话，还会近一步执行location{}里面的语句,当然前提是请求必须要匹配该location。
当rewrite规则在location{}里，遇到break后，本location{}与其他location{}的所有rewrite/return规则都不再执行。
当rewrite规则在location{}里，遇到last后，本location{}里后续rewrite/return规则不执行，但重写后的url再次从头开始执行所有规则，哪个匹配执行哪个。

来源：https://my.oschina.net/u/3964315/blog/3127999

标签

nginx

last

location

rewrite