欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  科技

nginx配置中location匹配规则详解

程序员文章站 2023-11-06 19:39:04
一、概述 nginx官方文档给出location语法如下: 1 location [=|~|~*|^~] uri { … } 其中,方括号中的四种标识符是可选项,用来改变请求字符串和uri的匹配方式。uri是待匹配的请求字符串,可以是不包含正则的字符串,这种模式被称为“标准的uri";也可以包含正则 ......
一、概述

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。