CODEWITHSUNDEEP
nginx
user650505
user650505

Reputation: 4011

Nginx location priority

What order do location directives fire in?

Upvotes: 337

Views: 187471

Answers (4)

Don Dilanga
Don Dilanga

Reputation: 3022

It fires in this order.

  1. = (exactly)

location = /path

  1. ^~ (forward match)

location ^~ /path

  1. ~ , ~* (regular expression case sensitive and insensitive)

location ~ /path/ , location ~* .(jpg|png|bmp)

  1. /

location /path

Upvotes: 162

Vincenzo Buttazzo
Vincenzo Buttazzo

Reputation: 239

Locations are evaluated in this order:

  1. location = /path/file.ext {} Exact match
  2. location ^~ /path/ {} Priority prefix match -> longest first
  3. location ~ /Paths?/ {} (case-sensitive regexp) and location ~* /paths?/ {} (case-insensitive regexp) -> first match
  4. location /path/ {} Prefix match -> longest first

The priority prefix match (number 2) is exactly as the common prefix match (number 4), but has priority over any regexp.

For both prefix matche types the longest match wins.

Case-sensitive and case-insensitive have the same priority. Evaluation stops at the first matching rule.

Documentation says that all prefix rules are evaluated before any regexp, but if one regexp matches then no standard prefix rule is used. That's a little bit confusing and does not change anything for the priority order reported above.

Upvotes: 21

Iceberg
Iceberg

Reputation: 3332

There is a handy online tool for testing location priority now:
location priority testing online

Upvotes: 57

Martin Redmond
Martin Redmond

Reputation: 13986

From the HTTP core module docs:

  1. Directives with the "=" prefix that match the query exactly. If found, searching stops.
  2. All remaining directives with conventional strings. If this match used the "^~" prefix, searching stops.
  3. Regular expressions, in the order they are defined in the configuration file.
  4. If #3 yielded a match, that result is used. Otherwise, the match from #2 is used.

Example from the documentation:

location  = / {
  # matches the query / only.
  [ configuration A ] 
}
location  / {
  # matches any query, since all queries begin with /, but regular
  # expressions and any longer conventional blocks will be
  # matched first.
  [ configuration B ] 
}
location /documents/ {
  # matches any query beginning with /documents/ and continues searching,
  # so regular expressions will be checked. This will be matched only if
  # regular expressions don't find a match.
  [ configuration C ] 
}
location ^~ /images/ {
  # matches any query beginning with /images/ and halts searching,
  # so regular expressions will not be checked.
  [ configuration D ] 
}
location ~* \.(gif|jpg|jpeg)$ {
  # matches any request ending in gif, jpg, or jpeg. However, all
  # requests to the /images/ directory will be handled by
  # Configuration D.   
  [ configuration E ] 
}

If it's still confusing, here's a longer explanation.

Upvotes: 510

Related Questions