前言

Location 是 Nginx 中一个非常核心的配置，这篇重点讲解一下 Location 的配置问题以及一些注意事项。

语法

关于 Location，举个简单的配置例子：

http { 
  server {
      listen 80;
    	server_name www.i-miqi.com;
    	location / {
      	root /home/www/ts/;
	      index index.html;
    	}
  }
}
www.i-miqi.com80/home/www/ts/index.html

我们看下 Location 的具体语法：

location [ = | ~ | ~* | ^~ ] uri { ... }
[ = | ~ | ~* | ^~ ]|
=
location = /test {
  return 200 "hello";
}

# /test ok
# /test/ not ok
# /test2 not ok
# /test/2 not ok
~
location ~ ^/test$ {
  [ configuration ] 
}

# /test ok
# /Test not ok
# /test/ not ok
# /test2 not ok
~*
location ~* ^/test$ {     
	[ configuration ] 
}

# /test ok
# /Test ok
# /test/ not ok
# /test2 not ok
^~
location ^~ /images/ {    
	[ configuration ] 
}

# /images/1.gif ok

而当你不使用这些语法的时候，只写 uri 的时候：

/
location / {     
	[ configuration ] 
}

# /index.html ok
location /test {
    [ configuration ] 
}

# /test ok
# /test2 ok
# /test/ ok

匹配顺序

当存在多个 location 的时候，他们的匹配顺序引用 Nginx 官方文档就是：

A location can either be defined by a prefix string, or by a regular expression. Regular expressions are specified with the preceding “~*” modifier (for case-insensitive matching), or the “~” modifier (for case-sensitive matching). To find location matching a given request, nginx first checks locations defined using the prefix strings (prefix locations). Among them, the location with the longest matching prefix is selected and remembered. Then regular expressions are checked, in the order of their appearance in the configuration file. The search of regular expressions terminates on the first match, and the corresponding configuration is used. If no match with a regular expression is found then the configuration of the prefix location remembered earlier is used.
If the longest matching prefix location has the “^~” modifier then regular expressions are not checked.
Also, using the “=” modifier it is possible to define an exact match of URI and location. If an exact match is found, the search terminates. For example, if a “/” request happens frequently, defining “location = /” will speed up the processing of these requests, as search terminates right after the first comparison. Such a location cannot obviously contain nested locations.

翻译整理后就是：

location 的定义分为两种：

~*~

而匹配 location 的顺序为：

=^~

再总结一下就是：

在顺序上，前缀字符串顺序不重要，按照匹配长度来确定，正则表达式则按照定义顺序。

=^~

我们举几个简单的例子复习下：

server {
    location /doc {
        [ configuration A ] 
    }
    location /docu {
        [ configuration B ] 
    }
}

# 请求 /document 使用 configuration B
# 虽然 /doc 也能匹配到，但在顺序上，前缀字符串顺序不重要，按照匹配长度来确定
server {
    location ~ ^/doc {
        [ configuration A ] 
    }
    location ~ ^/docu {
        [ configuration B ] 
    }
}

# 请求 /document 使用 configuration A
# 虽然 ~ ^/docu 也能匹配到，但正则表达式则按照定义顺序
server {
    location ^~ /doc {
        [ configuration A ] 
    }
    location ~ ^/docu {
        [ configuration B ] 
    }
}

# 请求 /document 使用 configuration A
# 虽然 ~ ^/docu 也能匹配到，但 ^~ 的优先级更高
server {
    location /document {
        [ configuration A ] 
    }
    location ~ ^/docu {
        [ configuration B ] 
    }
}

# 请求 /document 使用 configuration B
# 虽然 /document 也能匹配到，但正则的优先级更高

root 与 alias 的区别

root
location /i/ {
    root /data/w3;
}
/i/top.gif/data/w3/i/top.gif
alias
location /i/ {
    alias /data/w3/images/;
}
/i/top.gif/data/w3/images/top.gif
rootlocationaliaslocation/i//i/

所以如果你这样使用 allias 定义一个路径：

location /images/ {
    alias /data/w3/images/;
}

其实使用 root 会更好：

location /images/ {
    root /data/w3;
}

server 和 location 中的 root

server 和 location 中都可以使用 root，举个例子：

http { 
  server {
      listen 80;
    	server_name www.i-miqi.com;
    	root /home/www/website/;
    	location / {
      	root /home/www/ts/;
	      index index.html;
    	}
  }
}
预览

如果两者都出现，是怎样的优先级呢？

简单的来说，就是就近原则，如果 location 中能匹配到，就是用 location 中的 root 配置，忽略 server 中的 root，当 location 中匹配不到的时候，则使用 server 中的 root 配置。