nginx location匹配规则

一、概述

nginx官方文档给出location语法如下：

1location [=|~|~*|^~] uri { … }

其中，方括号中的四种标识符是可选项，用来改变请求字符串和uri的匹配方式。uri是待匹配的请求字符串，可以是不包含正则的字符串，这种模式被称为“标准的uri"；也可以包含正则，这种模式被称为"正则uri"，如下：

location ~ .*\.(php|php5)?$ {

}

二、四种可选的标识符

标识符描述

=精确匹配；用于标准uri前，要求请求字符串和uri严格匹配。如果匹配成功，就停止匹配，立即执行该location里面的请求。

~正则匹配；用于正则uri前，表示uri里面包含正则，并且区分大小写。

~*正则匹配；用于正则uri前，表示uri里面包含正则，不区分大小写。

^~非正则匹配；用于标准uri前，nginx服务器匹配到前缀最多的uri后就结束，该模式匹配成功后，不会使用正则匹配。

无普通匹配（最长字符匹配）；与location顺序无关，是按照匹配的长短来取匹配结果。若完全匹配，就停止匹配。

备注：

1、如果uri里面包含正则表达式，就必须使用~或~*标识符；

2、针对~和~*匹配标识符，可以在前面加上!来取反，如下：

!~表示正则不匹配，区分大小写。

!~*表示正则不匹配，不区分大小写。

2.1 “=”精准匹配案例

location  = /login {

  # 精确匹配 /login ，匹配成功后，立即结束

}

2.2 “~”区分大小写正则匹配案例

location ~ /images/ {

  #正则匹配，区分大小写，匹配成功后，立即结束

}

2.3 “~*”不区分大小写正则匹配案例

location ~* /images/ {

  #正则匹配，不区分大小写，匹配成功后，立即结束

}

2.4 “^~” 不进行正则匹配的标准匹配

location ^~ /images/ {

  # 匹配任何以 /images/ 开头的地址，匹配符合以后，停止往下搜索正则，采用这一条。

}

2.5 普通匹配（最长字符匹配）

location  /blog/ {

  # 与location顺序无关

  # 若完全匹配成功，就不在继续匹配，否则还会进行正则匹配

}

三、location匹配顺序

在没有标识符的请求下，匹配规则如下：

1、nginx服务器首先在server块的多个location块中搜索是否有标准的uri和请求字符串匹配。如果有多个标准uri可以匹配，就匹配其中匹配度最高的一个location。

2、然后，nginx在使用location块中，正则uri和请求字符串，进行匹配。如果正则匹配成功，则结束匹配，并使用这个location处理请求；如果正则匹配失败，则使用标准uri中，匹配度最高的location。

备注：

1、如果有精确匹配，会先进行精确匹配，匹配成功，立刻返回结果。

2、普通匹配与顺序无关，因为按照匹配的长短来取匹配结果。

3、正则匹配与顺序有关，因为是从上往下匹配。(首先匹配，就结束解析过程)

4、在location中，有一种统配的location，所有的请求，都可以匹配，如下：

location  / {

  # 因为所有的地址都以 / 开头，所以这条规则将匹配到所有请求

  # 但是正则和最长字符串会优先匹配

}

结合标识符，匹配顺序如下：

(location =) > (location 完整路径) > (location ^~ 路径) > (location ~,~* 正则顺序) > (location 部分起始路径) > (location /)

即

（精确匹配）> (最长字符串匹配，但完全匹配) >（非正则匹配）>（正则匹配）>（最长字符串匹配，不完全匹配）>（location通配）

五、案例

假设，现有如下一些规则：

location = / {  

   //精确匹配/ ，主机名后面不能带任何字符串

    echo"规则A";

}

location = /login {

  //精确匹配 /login 开头的地址，匹配符合以后，不在继续往下搜索 

    echo"规则B";

}

location ^~ /blog/ { 

  //非正则匹配，匹配/blog/后，停止往下搜索正则，采用这一条

  echo"规则C";

}

location ~  \.(gif|jpg|png|js|css)$ {

    //区分大小写的正则匹配  若匹配成功，停止往下搜索正则，采用这一条

    echo"规则D";

}

location ~* \.png$ {  

   //区分大小写的正则匹配 ，停止往下搜索正则，采用这一条

    echo"规则E";

}

location / {

  //因为所有的地址都以 / 开头，所以这条规则将匹配到所有请求

  //如果没任何规则匹配上，就采用这条规则

    echo"规则F";

}

location /blog/detail { 

  //最长字符串匹配，若完全匹配成功，就不在继续匹配，否则还会进行正则匹配

  echo"规则G";

}

location /images {  

    //最长字符串匹配，同上 

    echo"规则Y";

}

location ^~ /static/files {  

    //非正则匹配，若匹配成功，就不在继续匹配

    echo"规则X";

}

1、当访问根路径/的时候，比如http://www.findme.wang/，会匹配规则A。

2、当访如http://www.findme.wang/login，会匹配规则B。

3、当访如http://www.findme.wang/login.html，会匹配规则F。

4、当访如http://www.findme.wang/blog/detail/3.html，会匹配规则C。分析思路，首先看看，“精确匹配”是否可以匹配成功，显示不可以；然后，看看是否可以“普通匹配”是否可以完全匹配，显示也没有；接着在看看非正则匹配，是否可以匹配成功，发现同规则C匹配上了，所以采用了规则C。

http://www.findme.wang/blog/detail/id/495.html