【nginx】location 匹配规则总结

1. 语法规则

语法规则，location关键字后面是可选的修饰符[ = | ~ | ~* | ^~ ]，后面是要匹配的字符串 uri，花括号中是要执行的操作。

 2. 修饰符说明

匹配优先级为 精确匹配 =，   其次前缀匹配 ^~，然后是正则匹配， 再然后匹配不带任何修饰的前缀匹配。最后是交给 / 通用匹配。一旦匹配成功，则不再进行后续的匹配

2.1 示例

配置文件如下

    location = /files/index.html {
        echo 1 index;
    }

    location ^~ /files/ {
        echo 2 files;
    }

    location ~ .png$ {
        echo 3 png;
    }

    location ~* /(pic|img) {
        echo 4 pic;
    }

    location /api/v1 {
        echo 5 api;
    }

    location / {
        echo 6 default;
    }

1.  请求 localhost/files/index.html  命中配置1，不再进行后续查找，返回 "1 index"
2.  请求 localhost/files/bb.png  命中配置2，不再进行后续查找，返回 "2 files"
3.  请求 localhost/pic/bb.png  命中配置3，不再进行后续查找，返回 "3 png"
4.  请求 localhost/img/x.jpg  命中配置4，不再进行后续查找，返回 "4 pic"
5.  请求 localhost//api/v1/users  命中配置5，，返回 " 5 api"
6.  请求 localhost/home/page/dd  未匹配其他location，命中默认配置，返回 " 6 default"

2.2 同时命中多个正则匹配时的优先级

从上例可以看到，当localhost/pic/bb.png 同时匹配了两个正则location配置，即以pic或img目录开头，同时以png结尾。最终生效的是 .png$的配置。

交换两条配置的顺序，修改conf文件如下：

    location ~* /(pic|img) {
        echo 4 pic;
    }

    location ~ .png$ {
        echo 3 png;
    }

再次请求localhost/pic/bb.png， 此时返回变为 "4 pic"

🎈结论：多个正则条件时，查找是按照在配置文件中的顺序进行的。

3. @的用法

@用来定义一个命名location。主要用于内部重定向，不暴露到正常的匹配流程中。可用于处理err_page

location / {
    try_files $uri $uri/ @not_found
}

location @not_found{
    echo file not found;
}