Skip to content

Latest commit

 

History

History
76 lines (66 loc) · 3.72 KB

location.md

File metadata and controls

76 lines (66 loc) · 3.72 KB

location表达式类型与优先级

  • location表达式类型

    • ~ 表示执行一个正则匹配,区分大小写
    • ~* 表示执行一个正则匹配,不区分大小写
    • ^~ 表示普通字符匹配。使用前缀匹配。如果匹配成功,则不再匹配其他location。
    • = 进行普通字符精确匹配。也就是完全匹配。
    • @ "@" 定义一个命名的 location,使用在内部定向时,例如 error_page, try_files
  • location优先级说明

    • 在nginx的location和配置中location的顺序无关。
    • 与location表达式的类型有关。
    • 相同类型的表达式,字符串长的会优先匹配。
    • 以下是按优先级排列说明:
      • 第一优先级:等号类型(=)的优先级最高。一旦匹配成功,则不再查找其他匹配项。
      • 第二优先级:^~类型表达式。一旦匹配成功,则不再查找其他匹配项。
      • 第三优先级:正则表达式类型(~ ~*)的优先级次之。如果有多个location的正则能匹配的话,则使用正则表达式最长的那个。
      • 第四优先级:常规字符串匹配类型。按前缀匹配。
  • location优先级示例 配置项如下:

      location = / {
      	# 仅仅匹配请求 /
      	[ configuration A ]
      }
      
      location / {
      	# 匹配所有以 / 开头的请求。但是如果有更长的同类型的表达式,则选择更长的表达式。
          # 如果有正则表达式可以匹配,则优先匹配正则表达式。
      	[ configuration B ]
      }
      
      location /documents/ {
      	# 匹配所有以 /documents/ 开头的请求。但是如果有更长的同类型的表达式,则选择更长的表达式。
      	#如果有正则表达式可以匹配,则优先匹配正则表达式。
      	[ configuration C ]
      }
      
      location ^~ /images/ {
      	# 匹配所有以 /images/ 开头的表达式,如果匹配成功,则停止匹配查找。
          # 所以,即便有符合的正则表达式location,也不会被使用
      	[ configuration D ]
      }
      
      location ~* \.(gif|jpg|jpeg)$ {
      	# 匹配所有以 gif jpg jpeg结尾的请求。
          # 但是 以 /images/开头的请求,将使用 [Configuration D]
      	[ configuration E ]
      }
    
  • 请求匹配示例

    • / -> [configuration A]
    • /index.html -> [configuration B]
    • /documents/document.html -> [configuration C]
    • /images/1.gif -> [configuration D]
    • /documents/1.jpg -> [configuration E]
    • 注意,以上的匹配和在配置文件中定义的顺序无关。
  • alias与root的区别

    • alias与root指定的url意义不同
      • root和alias都可以定义在location模块中,都是用来指定请求资源的真实路径,比如:

          location /abc/ {
              root /data/www;
          }
        
      • 请求 http://IP:port/abc/123.png 时,那么在服务器里面对应的真正的资源是:/data/www/abc/123.png

      • 注意:root真实路径是root指定的值加上location指定的值。

      • alias 正如其名,alias指定的路径是location的别名,不管location的值怎么写,资源的真实路径都是 alias 指定的路径,比如:

          location /abc/ {
              alias /data/www;
          }
        
      • 请求http://IP:port/abc/123.png时,那么在服务器里面对应的真正的资源是:/data/www/123.png

      • 注意:alias真实路径是alias指定的值,不包含location指定的值了。

    • 在一个location中,alias可以存在多个,但是root只能有一个
    • alias只能存在与location中,但是root可以用在serverhttplocation
    • alias后面必须要/结束,否则会找不到文件,而root/可有可无