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;
}
- 请求 localhost/files/index.html 命中配置1,不再进行后续查找,返回 "1 index"
- 请求 localhost/files/bb.png 命中配置2,不再进行后续查找,返回 "2 files"
- 请求 localhost/pic/bb.png 命中配置3,不再进行后续查找,返回 "3 png"
- 请求 localhost/img/x.jpg 命中配置4,不再进行后续查找,返回 "4 pic"
- 请求 localhost//api/v1/users 命中配置5,,返回 " 5 api"
- 请求 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;
}