从源码角度理解nginx配置中last与break的区别

nginx 配置文件中经常会用到last与break指令。那么两者之间的区别如何呢？

以nginx-1.0.14的源码为例：
/src/http/modules/ngx_http_rewrite_module.c (366-389行)

    
    
    
    

     
     
     
     
 
      if  
      (cf 
      ->args 
      ->nelts  
      ==  
      4 
      )  
      { 
      
 
      if  
      (ngx_strcmp 
      (value 
      [ 
      3 
      ]. 
      data 
      ,  
      "last" 
      )  
      ==  
      0 
      )  
      { 
      
last  
      =  
      1 
      ; 
      
 
      
 
      }  
      else  
      if  
      (ngx_strcmp 
      (value 
      [ 
      3 
      ]. 
      data 
      ,  
      "break" 
      )  
      ==  
      0 
      )  
      { 
      
 
      regex->break_cycle = 1;
last  
      =  
      1 
      ; 
      
 
      
 
      }  
      else  
      if  
      (ngx_strcmp 
      (value 
      [ 
      3 
      ]. 
      data 
      ,  
      "redirect" 
      )  
      ==  
      0 
      )  
      { 
      
regex 
      ->status  
      = NGX_HTTP_MOVED_TEMPORARILY 
      ; 
      
regex 
      ->redirect  
      =  
      1 
      ; 
      
last  
      =  
      1 
      ; 
      
 
      
 
      }  
      else  
      if  
      (ngx_strcmp 
      (value 
      [ 
      3 
      ]. 
      data 
      ,  
      "permanent" 
      )  
      ==  
      0 
      )  
      { 
      
regex 
      ->status  
      = NGX_HTTP_MOVED_PERMANENTLY 
      ; 
      
regex 
      ->redirect  
      =  
      1 
      ; 
      
last  
      =  
      1 
      ; 
      
 
      
 
      }  
      else  
      { 
      
ngx_conf_log_error 
      (NGX_LOG_EMERG 
      , cf 
      ,  
      0 
      , 
      
 
      "invalid parameter \"%V\"" 
      ,  
      &value 
      [ 
      3 
      ] 
      ) 
      ; 
      
 
      return NGX_CONF_ERROR 
      ; 
      
 
      } 
      
 
      } 
     
    
    
    
    

break 与last的区别在于多了一行，regex->break_cycle = 1; 那么我们来看看这行语句具体有何含义。
break_cycle赋值后会被ngx_http_script_regex_code_t *code 调用。

具体在/src/http/ngx_http_script.c (1007行),代码段如下：

    
    
    
    

     
     
     
     
 
      if  
      (code 
      ->break_cycle 
      )  
      { 
      
 
      r->valid_location = 0;
 
      r->uri_changed = 0; 
 
      
 
      }  
      else  
      { 
      
r 
      ->uri_changed  
      =  
      1 
      ; 
      
 
      } 
     
    
    
    
    

r->valid_location = 0; 表示break指令不会继续作用于之后的location域。
r->uri_changed = 0;表示break指令停止继续匹配。而last指令会继续匹配下去。
继续看如下代码
/src/http/ngx_http_core_module.c(1038行)

    
    
    
    

     
     
     
     

       ngx_http_core_post_rewrite_phase 
      (ngx_http_request_t  
      *r 
      , 
      
ngx_http_phase_handler_t  
      *ph 
      ) 
      
 
      { 
      
ngx_http_core_srv_conf_t  
      *cscf 
      ; 
      
 
      
ngx_log_debug1 
      (NGX_LOG_DEBUG_HTTP 
      , r 
      ->connection 
      -> 
      log 
      ,  
      0 
      , 
      
 
      "post rewrite phase: %ui" 
      , r 
      ->phase_handler 
      ) 
      ; 
      
 
      
 
      if  
      ( 
      !r 
      ->uri_changed 
      )  
      { 
      
r 
      ->phase_handler 
      ++; 
      
 
      return NGX_AGAIN 
      ; 
      
 
      } 
     
    
    
    
    

r->uri_changed = 0; 内核会跳出处理下一个请求。
last指令 r->uri_changed = 1; 会继续不停的匹配。

总结：使用break指令后，不会继续作用于随后的location域，不会循环继续匹配。last指令恰恰相反。

从效率上来说尽量使用break指令。