nginx location匹配规则详解

July 21, 2013

#####Nginx location 配置语法
```
Syntax:    location [ = | ~ | ~* | ^~ ] uri { ... }
location @name { ... }
Default:    —
Context:    server, location
```
```
1. location [ = | ~ | ~* | ^~ ] uri { ... }
2. location @name { ... }    
```
location 配置可以有两种配置方法
> 1.前缀 + uri（字符串/正则表达式）
2.@ + name

前缀含义
>   =  ：精确匹配（必须全部相等）
    ~  ：大小写敏感
    ~* ：忽略大小写
    ^~ ：只需匹配uri部分
    @  ：内部服务跳转

Location 基础知识
1.location 是在 server 块中配置。
2.可以根据不同的 URI 使用不同的配置（location 中配置），来处理不同的请求。
3.location 是有顺序的，会被第一个匹配的location 处理。

#####Location 配置
1.=，精确匹配
```
        location = / {
            #规则
        }
        # 则匹配到 `http://www.example.com/` 。 
```
2.~，大小写敏感
```
        location ~ /Example/ {
                #规则
        }
        #请求示例
        #http://www.example.com/Example/  [成功]
        #http://www.example.com/example/  [失败]
```
3.~*，大小写忽略
```
    location ~* /Example/ {
                #规则
    }
    # 则会忽略 uri 部分的大小写
    #http://www.example.com/Example/  [成功]
    #http://www.example.com/example/  [成功]
```
4.^~，只匹配以 uri 开头
```
    location ^~ /img/ {
            #规则
    }
    #以 /img/ 开头的请求，都会匹配上
    #http://www.example.com/img/a.jpg   [成功]
    #http://www.example.com/img/b.mp4 [成功]
```
5.@，nginx内部跳转
```
    location /img/ {
        error_page 404 @img_err;
    }
    
    location @img_err {
        # 规则
    }
    #以 /img/ 开头的请求，如果链接的状态为 404。则会匹配到 @img_err 这条规则上。
```
#####匹配优先级
1：前缀匹配和精确匹配优先级最高，取最长匹配。
2：正则匹配顺序为nginx配置文件里location书写顺序，无相 应匹配规则时，以最早一次前缀匹配为准。
3：@匹配通常用于重定向，无单独匹配规则，无法被嵌套，本身也不能包含嵌套。
4：location可嵌套。
5：nginx先检查前缀字符串，然后检查正则表达式，如果前缀匹配匹配到了，并且前缀匹配有“^~” 修饰符，就不配正则了；如果没有“^~” ，即使前缀匹配到了，也要去匹配正则表则，如果正则表达式匹配到了，就是用正则表达式的，没有就是用前缀字符串匹配到的路径；
6：

#####参考例子
```
location = / {
    [ configuration A ]
}

location / {
    [ configuration B ]
}

location /documents/ {
    [ configuration C ]
}

location ^~ /images/ {
    [ configuration D ]
}

location ~* \.(gif|jpg|jpeg)$ {
    [ configuration E ]
}
```
上述匹配顺序如下：
1： “/” 匹配规则 A，
2：“/index.html” 匹配规则B，
3：“/documents/document.html” 匹配规则C，
4：“/images/1.gif” 匹配规则D，
5：“/documents/1.jpg”匹配规则E。
> 顺序A>E>C>D>C>B

######有正则匹配，无符号修饰
规则：无“^~”， 最终使用正则匹配到的路径，正则匹配不到，使用字符串前缀匹配最长的
```
xxxx/
├── image1
│   └── test.txt
├── img
│   └── test.txt
├── img2
├── t1.txt
│   └── test.txt
└── test.txt
```
nginx规则如下：
```
#规则A
 location / {
  root   /var/www;
 }
 #规则B
 location /img {
  root   /var/www/img;
 }
 #规则C
 location ^~ /img/ {
  root   /var/www/img2;
 }
 #规则D
 location ~* \/img\/ {
  root   /var/www/image1;
 }
 #规则E
 location ~* \.txt {
  root   /var/www/image1;
 }

```
验证：
http://localhost/image1/xxx
匹配规则A

http://localhost/img
匹配规则B

http://localhost/img/xxx
匹配规则C

http://localhost/img/xxx/t.txt
匹配规则B

> txt匹配规则
http://localhost/img1/xxx/t.txt
http://localhost/img1/xxx/t.txt?xxxx=aaa
 http://localhost/img.txt
匹配规则E
http://localhost/test.txt
匹配规则A
http://localhost/img/test1.txt
匹配规则C

> 当规则E不存在时
 http://localhost/test.txt
  http://localhost/test1.txt
  http://localhost/t1.txt/test.txt
匹配规则F

#####参考：
http://nginx.org/en/docs/http/ngx_http_core_module.html#location
https://segmentfault.com/a/1190000009237425
https://blog.csdn.net/truong/article/details/49967393

添加新评论