nginx中的location指令

1、location 介绍

location是Nginx中的块级指令(block directive)，location指令的功能是用来匹配不同的url请求，进而对请求做不同的处理和响应，这其中较难理解的是多个location的匹配顺序，本文会作为重点来解释和说明。

开始之前先明确一些约定，我们输入的网址叫做请求URI，nginx用请求URI与location中配置的URI做匹配。

2、localtion 语法

 location有两种匹配规则：

• 匹配URL类型，有四种参数可选，当然也可以不带参数。

location [ = | ~ | ~* | ^~ ] uri { … }

• 命名location，用@标识，类似于定于goto语句块。

location @name { … }

location匹配参数解释：

1. “=” ，精确匹配

   # 内容要同表达式完全一致才匹配成功
   
   location = /abc/ {
     .....
   }
   # 只匹配http://abc.com/abc
   #http://abc.com/abc [匹配成功]
   #http://abc.com/abc/index [匹配失败]

2.  “~”，执行正则匹配，区分大小写。

   location ~ /Abc/ {
     .....
   }
   #http://abc.com/Abc/ [匹配成功]
   #http://abc.com/abc/ [匹配失败]

3. “~*”，执行正则匹配，忽略大小写

   location ~* /Abc/ {
     .....
   }
   # 则会忽略 uri 部分的大小写
   #http://abc.com/Abc/ [匹配成功]
   #http://abc.com/abc/ [匹配成功]

4. “^~”，表示普通字符串匹配上以后不再进行正则匹配。

   location ^~ /index/ {
     .....
   }
   #以 /index/ 开头的请求，都会匹配上
   #http://abc.com/index/index.page  [匹配成功]
   #http://abc.com/error/error.page [匹配失败]

5. 不加任何规则

   # 不加任何规则时，默认是大小写敏感，前缀匹配，相当于加了“~”与“^~”
   
   location /index/ {
     ......
   }
   #http://abc.com/index  [匹配成功]
   #http://abc.com/index/index.page  [匹配成功]
   #http://abc.com/test/index  [匹配失败]
   #http://abc.com/Index  [匹配失败]
   # 匹配到所有uri

6. “@”，nginx内部跳转

   location /index/ {
     error_page 404 @index_error;
   }
   location @index_error {
     .....
   }
   #以 /index/ 开头的请求，如果链接的状态为 404。则会匹配到 @index_error 这条规则上。

   
   3、location匹配顺序

•  = > ^~ > ~ | ~* > 最长前缀匹配 > /

序号越小优先级越高

1. location =    # 精准匹配
2. location ^~   # 带参前缀匹配
3. location ~    # 正则匹配（区分大小写）
4. location ~*   # 正则匹配（不区分大小写）
5. location /a   # 普通前缀匹配，优先级低于带参数前缀匹配。
6. location /    # 任何没有匹配成功的，都会匹配这里处理

举例

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
}

匹配结果：

访问根目录/， 比如http://localhost/ 将匹配规则A
 
访问 http://localhost/login 将匹配规则B，http://localhost/register 则匹配规则H
 
访问 http://localhost/static/a.html 将匹配规则C
 
访问 http://localhost/b.jpg 将匹配规则D和规则E，但是规则D顺序优先，规则E不起作用， 而 http://localhost/static/c.png 则优先匹配到 规则C
 
访问 http://localhost/a.PNG 则匹配规则E， 而不会匹配规则D，因为规则E不区分大小写。
 
访问 http://localhost/a.xhtml 不会匹配规则F和规则G，http://localhost/a.XHTML不会匹配规则G，因为不区分大小写。规则F，规则G属于排除法，符合匹配规则但是不会匹配到。
 
访问 http://localhost/qll/id/1111 则最终匹配到规则H，因为以上规则都不匹配。

4、location URI结尾带不带 /

1. 如果 URI 结构是 https://domain.com/ 的形式，尾部有没有 / 都不会造成重定向。因为浏览器在发起请求的时候，默认加上了 / 。虽然很多浏览器在地址栏里也不会显示 / 。这一点，可以访问百度验证一下。
2. 如果 URI 的结构是 https://domain.com/some-dir/ 。尾部如果缺少 / 将导致重定向。因为约定，URL 尾部的 / 表示目录，没有 / 表示文件。所以访问 /some-dir/ 时，服务器会自动去该目录下找对应的默认文件。如果访问 /some-dir 的话，服务器会先去找 some-dir 文件，找不到的话会将 some-dir 当成目录，重定向到 /some-dir/ ，去该目录下找默认文件。

举个例子：

server {
    listen       9001;
    server_name  www.abc.com;
 
    location ~ /edu {
        proxy_pass http://127.0.0.1:8080;
     }
}

访问 /edu 时，服务器首先去找edu文件，找不到则将edu当做目录，重定向到 /edu/，在该目录下找默认文件。

但是如果想这两种请求对应不同的处理，就要明确增加不带/结尾的location配置。例如：

location  /doc {
  proxy_pass http://www.doc123.com
}
location  /doc/ {
  proxy_pass http://www.doc456.com
}

————————————————
版权声明：本文为CSDN博主「凤舞飘伶」的原创文章，遵循CC 4.0 BY-SA版权协议，转载请附上原文出处链接及本声明。
原文链接：https://blog.csdn.net/woshaguayi/article/details/115320956