Nginx 教程 : nginx配置中location匹配规则详解

1. 概述

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

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

2. 可选的标识符

标识符	描述
=	精确匹配；用于标准uri前，要求请求字符串和uri严格匹配。如果匹配成功，就停止匹配，立即执行该location里面的请求。
~	正则匹配；用于正则uri前表示uri里面包含正则，并且区分大小写。
~*	正则匹配；用于正则uri前，表示uri里面包含正则，不区分大小写。
!~	对 ~ 结果取非
!~*	对 ~* 结果取非
^~	非正则匹配；用于标准uri前，nginx服务器匹配到前缀最多的uri后就结束，该模式匹配成功后，不会使用正则匹配。
无	普通匹配（最长字符匹配）；与location顺序无关，是按照匹配的长短来取匹配结果。若完全匹配，就停止匹配。

正则表达式	描述
*	重复前面的字符0次或者多次
?	重复前面的字符0次或者1次
+	重复前面的字符一次或者多次
.	匹配除换行符以外的任意一个字符
(a|b)	匹配a或者b
^	以…开头
$	以…结尾
{n}	重复前面的字符n次
{n,}	重复前面的字符n次或者更多次
{n,m}	重复前面的字符n-m次
*?	重复前面的字符0次或者多次,但尽可能少重复
+?	重复前面的字符一次或者多次,但尽可能少重复
??	重复前面的字符0次或者一次,但尽可能少重复
{n,m}?	重复前面的字符n-m次,但尽可能少重复
{n}?	重复前面的字符n次,但尽可能少重复
\W	匹配任意不是字母,数字,下划线,汉子的字符(特殊符号)
\S	匹配任意不是空白符的字符
\D	匹配任意非数字的字符
\B	匹配任意不是单词开头或者结尾的位置
[a]	匹配单字符a
[a-z]	匹配a-z字符内任意一个
[^a]	匹配除了a之外的任意字符
^abc	匹配除了abc这几个字母以外的任意字符

备注：

• 如果uri里面包含正则表达式，就必须使用 ~ 或 ~* 标识符；
• 针对 ~ 和 ~* 匹配标识符，可以在前面加上!来取反，如下：
        !~ 表示正则不匹配，区分大小写。
        !~* 表示正则不匹配，不区分大小写。

3. 匹配案例

	案例匹配实例

(1) “=”精准匹配案例

	location  = /login {
	 # 精确匹配 /login ，匹配成功后，立即结束
	}

(2)  “~”区分大小写正则匹配案例

	location ~ /images/ {
	  #正则匹配，区分大小写，匹配成功后，立即结束
	}

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

	location ~* /images/ {
	  #正则匹配，不区分大小写，匹配成功后，立即结束
	}

(4)  “^~” 不进行正则匹配的标准匹配

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

(5) 普通匹配（最长字符匹配）

	location  /blog/ {
	  # 与location顺序无关
	  # 若完全匹配成功，就不在继续匹配，否则还会进行正则匹配
	}

4. location匹配顺序

(location =) > (location 完整路径) > (location ^~ 路径) > (location ~,~* 正则顺序) > (location 部分起始路径) > (location /)
即
（精确匹配）> (最长字符串匹配，但完全匹配) >（非正则匹配）>（正则匹配）>（最长字符串匹配，不完全匹配）>（location通配）

	在没有标识符的请求下，匹配规则如下：
	1、nginx服务器首先在server块的多个location块中搜索是否有标准的uri和请求字符串匹配。
	如果有多个标准uri可以匹配，就匹配其中匹配度最高的一个location。
	2、然后，nginx在使用location块中，正则uri和请求字符串，进行匹配。
	如果正则匹配成功，则结束匹配，并使用这个location处理请求；
	如果正则匹配失败，则使用标准uri中，匹配度最高的location。
	
	备注：
	
	1、如果有精确匹配，会先进行精确匹配，匹配成功，立刻返回结果。
	
	2、普通匹配与顺序无关，因为按照匹配的长短来取匹配结果。
	
	3、正则匹配与顺序有关，因为是从上往下匹配。(首先匹配，就结束解析过程)
	
	4、在location中，有一种统配的location，所有的请求，都可以匹配，如下：
	location  / {
	  # 因为所有的地址都以 / 开头，所以这条规则将匹配到所有请求
	  # 但是正则和最长字符串会优先匹配
	}

5. 案例

	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。