NGINX location 在配置中的優先順序

@exinnet發表於2015-06-26

location表示式型別

  • ~ 表示執行一個正則匹配,區分大小寫
  • ~* 表示執行一個正則匹配,不區分大小寫
  • ^~ 表示普通字元匹配。使用字首匹配。如果匹配成功,則不再匹配其他location。
  • = 進行普通字元精確匹配。也就是完全匹配。
  • @ 它定義一個命名的 location,使用在內部定向時,例如 error_page, try_files

location優先順序說明

在nginx的location和配置中location的順序沒有太大關係。正location表示式的型別有關。相同型別的表示式,字串長的會優先匹配。

以下是按優先順序排列說明:

  1. 等號型別(=)的優先順序最高。一旦匹配成功,則不再查詢其他匹配項。
  2. ^~型別表示式。一旦匹配成功,則不再查詢其他匹配項。
  3. 正規表示式型別(~ ~*)的優先順序次之。如果有多個location的正則能匹配的話,則使用正規表示式最長的那個。
  4. 常規字串匹配型別。按字首匹配。

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

注意,以上的匹配和在配置檔案中定義的順序無關。

相關文章