当前位置: 首页 > 工具软件 > ngx-formly > 使用案例 >

nginx ngx_http_core_module location指令详解

马国源
2023-12-01
Syntax:     location [ = | ~ | ~* | ^~ ] uri { ... }
Default:    —
Context:    server, location
模式含义
location = /uri=表示精确匹配,只有完全匹配上才能生效
location ^~ /uri^~开头对URL路径进行前缀匹配,并且在正则之前。
location ~ pattern开头表示区分大小写的正则匹配
location ~* pattern开头表示不区分大小写的正则匹配
location /uri不带任何修饰符,也表示前缀匹配,但是在正则匹配之后
location /通用匹配,任何未匹配到其它location的请求都会匹配到,相当于switch中的default

注意:location匹配的变量为$request_uri,即路径和请求文件部分,不包括参数

前缀匹配时,Nginx 不对 url 做编码,因此请求为 /static/20%/aa,可以被规则 ^~ /static/ /aa 匹配到(注意是空格),并且将多个连续的反斜杠压缩为一个 /ab ,被视为 /a/b。
多个 location 配置的情况下匹配顺序为

  • 首先精确匹配 =
  • 其次前缀匹配 ^~
  • 其次是按文件中顺序的正则匹配
  • 然后匹配不带任何修饰的前缀匹配。
  • 最后是交给 / 通用匹配
  • 当有匹配成功时候,停止匹配,按当前匹配规则处理请求

注意:前缀匹配,如果有包含关系时,按最大匹配原则进行匹配。比如在前缀匹配:location /dir01 与 location /dir01/dir02,如有请求 http://localhost/dir01/dir02/file 将最终匹配到 location /dir01/dir02
例子,有如下匹配规则:

location = / {
   echo "规则A";
}
location = /login {
   echo "规则B";
}
location ^~ /static/ {
   echo "规则C";
}
location ^~ /static/files {
    echo "规则X";
}
location ~ \.(gif|jpg|png|js|css)$ {
   echo "规则D";
}
location ~* \.png$ {
   echo "规则E";
}
location /img {
    echo "规则Y";
}
location / {
   echo "规则F";
}

那么产生的效果如下:

注意:进行前缀匹配时,会先一直找到最长的前缀匹配,然后看该前缀匹配有没有前置的^~修饰符,如果没有^~ 修饰符就接着去查找正则匹配,查找到匹配正则匹配后执行该location。如果最长前缀匹配有^~修饰符则命中该location,不回去匹配其他的正则匹配location;列子如下:

#请求 http://localhost.com/static/files/test.jpg  命中规则D,如果规则X有 ^~修饰符,则会命中规则X;
location ^~ /static/ {
    echo "规则C";
}
location  /static/files {
    echo "规则X";
}
location ~ \.(gif|jpg|png|js|css)$ {
    echo "规则D
}

参考
nginx文档
openresty最佳实践

 类似资料: