Nginx location 模块学习

根据请求的URI设置配置集合。所有的匹配都是在解码以后的，相邻的两个/会被翻译成一个/。

一个location规则可以是一个 前缀字符串（prefix string） 也可以是一个正则表达式（Regular expressions）
正则表达式由修饰符“ * ” 开头（用于大小写不敏感的匹配），或者由修饰符“~”开头（用于大小写敏感的匹配）。给一个请求去查找匹配的时候，nginx首先检查使用前缀字符串( prefix string )定义的规则。其中，所有匹配中的规则最长的一条会被确认并标记，继续检查正则表达式，按照配置文件的顺序检查。当有匹配的正则记录以后立即停止，并立即使用该条配置。如果没有一条正则表达式被匹配到，则使用之前前缀字符串匹配到的配置。

location 是可以嵌套使用的，除了下面提到的一些意外。

如果最长匹配前缀位置具有“^〜”修饰符，则不检查正则表达式。

同样，如果使用修饰符“=”可以做精确匹配。完全匹配到规则，则停止搜索。举例，如果 “/”请求经常发生，可以定义“location = /” 可以加速请求的处理速度，因为搜索在第一次比对正确以后会立即终止。这样的规则显然不能被嵌套起来。

让我们来举一些例子：

location = / {
    [ configuration A ]
}

location / {
    [ configuration B ]
}

location /documents/ {
    [ configuration C ]
}

location ^~ /images/ {
    [ configuration D ]
}

location ~* \.(gif|jpg|jpeg)$ {
    [ configuration E ]
}

"/"请求匹配A规则，"/index.html"请求匹配B规则，"/documents/document.html"请求匹配C规则， "/images/1.gif"请求匹配D规则，"documents/1.jpg" 请求匹配规则E

指令作用匹配指定的请求uri（请求uri不包含查询字符串，如http://localhost:8080/test?id=10，请求uri是/test）语法形式location [ = | ~ | ~* | ^~ | @] /uri/ { configuration }匹配模式及顺序匹配字符串分为两种：普通字符串（literal string）和正则表达式（regular expression），其中 ~ 和 ~* 用于正则表达式， 其他前缀和无任何前缀都用于普通字符串。匹配顺序是：1、先匹配普通字符串，将最精确的匹配暂时存储；2、然后按照配置文件中的声明顺序进行正则表达式匹配，只要匹配到一条正则表达式，则停止匹配，取正则表达式为匹配结果；3、如果所有正则表达式都匹配不上，则取1中存储的结果；4、如果普通字符串和正则表达式都匹配不上，则报404 NOT FOUND。location = /uri =开头表示精确前缀匹配，只有完全匹配才能生效。location ^~ /uri ^~开头表示普通字符串匹配上以后不再进行正则匹配。location ~ pattern ~开头表示区分大小写的正则匹配。location ~* pattern ~开头表示不区分大小写的正则匹配。location /uri 不带任何修饰符，表示前缀匹配。location / 通用匹配，任何未匹配到其他location的请求都会匹配到。注意：正则匹配会根据匹配顺序，找到第一个匹配的正则表达式后将停止搜索。普通字符串匹配则无视顺序，只会选择最精确的匹配。常用配置指令alias、root、proxy_pass1、alias——别名配置，用于访问文件系统，在匹配到location配置的URL路径后，指向alias配置的路径，如：
location /test/ {
alias /usr/local/;
}
请求/test/1.jpg（省略了协议和域名），将会返回文件/usr/local/1.jpg。如果alias配置在正则匹配的location内，则正则表达式中必须包含捕获语句（也就是括号()），而且alias配置中也要引用这些捕获值。如：
location ~ /img/(.+.(gif|png|jpeg)) {
alias /usr/local/images/$1;
}
请求中只要能匹配到正则，比如/img/flower.png 或者 /resource/img/flower.png，都会转换为请求/usr/local/images/flower.png。2、root——根路径配置，用于访问文件系统，在匹配到location配置的URL路径后，指向root配置的路径，并把请求路径附加到其后，如：
location /test/ {
root /usr/local/;
}
请求/test/1.jpg，将会返回文件/usr/local/test/1.jpg。3、proxy_pass——反向代理配置，用于代理请求，适用于前后端负载分离或多台机器、服务器负载分离的场景，在匹配到location配置的URL路径后，转发请求到proxy_pass配置额URL，是否会附加location配置路径与proxy_pass配置的路径后是否有"/"有关，有"/"则不附加，如：
location /test/ {
proxy_pass http://127.0.0.1:8080/;
}
请求/test/1.jpg，将会被nginx转发请求到http://127.0.0.1:8080/1.jpg（未附加/test/路径）。附：匹配规则