nginx配置中location匹配规则详解

时间:2024-12-18 14:36:14
一、概述

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

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

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

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

二、四种可选的标识符

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

备注:

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

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

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

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

2.1 “=”精准匹配案例

1
2
3
location  = /login {
  # 精确匹配 /login ,匹配成功后,立即结束
}

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

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

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

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

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

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

2.5 普通匹配(最长字符匹配)

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

三、location匹配顺序

在没有标识符的请求下,匹配规则如下:

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

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

备注:

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

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

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

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

1
2
3
4
location  / {
  # 因为所有的地址都以 / 开头,所以这条规则将匹配到所有请求
  # 但是正则和最长字符串会优先匹配
}

结合标识符,匹配顺序如下:

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

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

五、案例

假设,现有如下一些规则:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
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。