Nginx location匹配规则详解 [3]

nginx.conf文件的server段下,location用于配置uri的命中规则和映射结果。

语法规则

语法规则:location [ = | ~ | ~* | ^~ | @ ] /uri/ { … }

  • =:进行常规字符精确匹配
  • ^~:常规字符匹配,遵循最长匹配原则,一般用来匹配目录
  • ~:区分大小写的正则匹配
  • ~*:不区分大小写的正则匹配
  • !~ 和 !~*:分别为区分大小写不匹配,及不区分大小写不匹配的正则
  • /:通配符

匹配优先级

location的匹配规则有点复杂,先贴一段官方对优先级的约定:

To summarize, the order in which directives are checked is as follows:

  1. Directives with the = prefix that match the query exactly. If found, searching stops.
  2. All remaining directives with conventional strings, longest match first. If this match used the ^~ prefix, searching stops.
  3. Regular expressions, in order of definition in the configuration file.
  4. If #3 yielded a match, that result is used. Else the match from #2 is used.

蹩脚翻译:

  1. 精确匹配以"="为前缀的模式,如果命中就作为最终结果返回;
  2. 所有剩下的以常规字符串为模式的匹配,遵循最长匹配原则。如果命中,且该匹配使用"^〜"为前缀,就将匹配结果作为最终结果返回,否则继续执行第3步的正则匹配;
  3. 按照配置文件中定义的顺序进行正则匹配,注意,正则location强调在配置文件中的物理顺序;
  4. 如果第3条规则产生匹配的话,结果被使用。否则,使用第2条规则的结果。

这段官方的说明并不好消化理解,需要做进一步说明,首先要避免两个误区:

1、 location 的匹配顺序是“先匹配正则,再匹配普通”。
矫正:造成这种误解的原因是:在某些配置下,正则匹配会覆盖普通匹配。location实际的匹配顺序其实是"先匹配普通,再匹配正则,普通命中可能会被正则命中覆盖"。

2、 location 的执行逻辑跟 location 的编辑顺序无关。
矫正:这句话不全对,"普通 location"的匹配规则是"最大前缀",因此"普通 location"的确与 location 编辑顺序无关;但是“正则 location ”的匹配规则是"顺序匹配,且只要匹配到第一个就停止后面的匹配";"普通location"与"正则 location"之间的匹配顺序是先匹配普通 location ,再"考虑"匹配正则 location 。注意这里的"考虑"是"可能"的意思,也就是说匹配完"普通 location"后,有的时候需要继续匹配"正则 location",有的时候则不需要继续匹配"正则 location"。两种情况下,不需要继续匹配正则 location:1)当普通 location 前面指定了"^~ "或者"=",特别告诉 Nginx 本条普通 location 一旦匹配上,则不需要继续正则匹配;2)当普通location 恰好严格匹配上,不是最大前缀匹配,则不再继续匹配正则。

总结一句话: “正则 location 匹配让步普通 location 的严格精确匹配结果;但覆盖普通 location 的最大前缀匹配结果”
《Nginx之location 匹配规则详解》,这篇博文作了非常详尽的匹配规则分析说明

为了方便记忆,将location匹配简化为3类:普通location内部匹配,正则location内部匹配,普通location与正则location匹配。规则继续拆分后得到下列单项:

  1. 优先匹配普通location,然后才会匹配正则location
  2. 普通location使用了"="或"^~"语法并且匹配成功,就停止后续匹配,将当前命中结果作为最终结果返回
  3. 第1条不满足的情况下,普通location遵循最长前缀匹配原则,如果精确匹配,则将当前命中结果作为最终结果返回,否则继续执行正则匹配;正则匹配若不命中,取普通匹配结果,否则正则匹配结果覆盖普通匹配结果
  4. 普通location内部匹配不关心location在配置文件中的编辑顺序,选最优解
  5. 正则location内部匹配关心location在配置文件中的编辑顺序,只要匹配到一条正则location ,就不再考虑编辑顺序靠后的location
  6. 正则 location 匹配让步普通location 的严格精确匹配结果;但覆盖普通 location 的最大前缀匹配结果

结合示例理解记忆(示例转自:https://www.cnblogs.com/sign-ptk/p/6723048.html
):

location = / {  
   #规则A  
}  
location = /login {  
   #规则B  
}  
location ^~ /static/ {  
   #规则C  
}  
location ~ \.(gif|jpg|png|js|css)$ {  
   #规则D  
}  
location ~* \.png$ {  
   #规则E  
}  
location !~ \.xhtml$ {  
   #规则F  
}  
location !~* \.xhtml$ {  
   #规则G  
}  
location / {  
   #规则H  
}  

那么产生的效果如下:

所以实际使用中,通常至少有三个匹配规则定义,如下:

#直接匹配网站根,通过域名访问网站首页比较频繁,使用这个会加速处理,官网如是说。  
#这里是直接转发给后端应用服务器了,也可以是一个静态首页  
# 第一个必选规则  
location = / {  
    proxy_pass http://tomcat:8080/index  
}  
   
# 第二个必选规则是处理静态文件请求,这是nginx作为http服务器的强项  
# 有两种配置模式,目录匹配或后缀匹配,任选其一或搭配使用  
location ^~ /static/ {  
    root /webroot/static/;  
}  
location ~* \.(gif|jpg|jpeg|png|css|js|ico)$ {  
    root /webroot/res/;  
}  
   
#第三个规则就是通用规则,用来转发动态请求到后端应用服务器  
#非静态文件请求就默认是动态请求,自己根据实际把握  
#毕竟目前的一些框架的流行,带.php,.jsp后缀的情况很少了  
location / {  
    proxy_pass http://tomcat:8080/  
}  
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 216,402评论 6 499
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,377评论 3 392
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 162,483评论 0 353
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,165评论 1 292
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,176评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,146评论 1 297
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,032评论 3 417
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,896评论 0 274
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,311评论 1 310
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,536评论 2 332
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,696评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,413评论 5 343
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,008评论 3 325
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,659评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,815评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,698评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,592评论 2 353