附001.Nginx location語法規則

一 location規則

1.1 location語法

基本語法： location [=|~|~*|^~]/uri/{...}

修飾符釋義：

=	#表示精確嚴格匹配，只有請求的url路徑與后面的字符串完全相等時，才會命中。同時若這個查詢匹配，將停止搜索並立即處理此請求。
~	#表示該規則是使用正則定義的，且區分大小寫；
^~	#表示uri以某個常規字符串開頭，匹配 URI 路徑。且nginx不對url做編碼，如請求為/static/20%/aa，可以被規則^~ /static/ /aa匹配到（注意是空格）；
~*	#表示該規則是使用正則定義的，且不區分大小寫；
/	#用戶所使用的代理（一般為瀏覽器）；

$http_x_forwarded_for	#通過代理服務器來記錄客戶端的ip地址；
$http_referer		#記錄用戶是從哪個鏈接訪問過來的。

1.2 location匹配過程

對請求的url序列化。例如，對%xx等字符進行解碼，去除url中多個相連的/，解析url中的.，..等。這一步是匹配的前置工作。

location有兩種表示形式，一種是使用前綴字符，一種是使用帶~或~*修飾符的正則。

其相應的匹配過程如下：

1. 如果找到了精確匹配的location，也就是使用了=修飾符的location，結束查找，使用它的配置。
2. 所有剩下的常規字符串，采用最長匹配；
3. 繼續判斷正則表達式的解析結果，按配置里的正則表達式順序為准，由上至下開始匹配，一旦匹配成功1個，立即返回結果，並結束解析過程。
4. 如果第3條規則產生匹配的話，結果被使用。否則，使用第2條規則的結果。

注意：普通命中順序無所謂，是因為按命中的長短來確定。正則命中，順序有所謂，因為是從前入往后命中的。

基於以上的匹配過程，我們可以得到以下兩點啟示：

1. 使用正則定義的location在配置文件中出現的順序很重要。因為找到第一個匹配的正則后，查找就停止了，后續定義的匹配（不管精度如何）都不再進行查找。
2. 使用精確匹配可以提高查找的速度。例如經常請求/的話，可以使用=來定義location。

1.3 location匹配優先級

由location匹配規則可知，其匹配優先級為：(location =) > (location 完整路徑) > (location ^~ 路徑) > (location ~,~* 正則順序) > (location 部分起始路徑) > (/) 。

二 location規則示例

2.1 環境預設

[root@nginx01 ~]# vi /etc/nginx/conf.d/location.conf
server {
    listen  80;
    server_name  location.linuxds.com;
    access_log  /var/log/nginx/location.access.log  main;
    error_log   /var/log/nginx/location.error.log  warn;
    location = / {
        add_header Content-Type text/plain;
        return 200 'A';
# 精確匹配 / ，主機名后面不能帶任何字符串
    }
    location = /login {
        add_header Content-Type text/plain;
        return 200 'B';
    }
    location ^~ /static/ {
        add_header Content-Type text/plain;
        return 200 'C';
# 匹配任何以 /static/ 開頭的地址，匹配以后，不在往下檢索正則，立即采用這一條。
    }
    location ^~ /static/files {
        add_header Content-Type text/plain;
        return 200 'D';
# 匹配任何以 /static/files 開頭的地址，匹配以后，不在往下檢索正則，立即采用這一條。
    }
    location ~ \.(gif|jpg|png|js|css|txt) {
        add_header Content-Type text/plain;
        return 200 'E';
    }
    location ~* \.txt$ {
        add_header Content-Type text/plain;
        return 200 'F';
# 匹配所有以 txt 結尾的請求
# 然而，所有請求 /static/ 下的txt會被 規則 C 處理，因為 ^~ 到達不了這一條正則。
    }
    location /image {
        add_header Content-Type text/plain;
        return 200 'G';
# 匹配任何以 /image/ 開頭的地址，匹配符合以后，還要繼續往下搜索；
# 只有后面的正則表達式沒有匹配到時，這一條才會采用這一條。
    }
    location / {
        add_header Content-Type text/plain;
        return 200 'H';
# 因為所有的地址都以 / 開頭，所以這條規則將匹配到所有請求。
# 但是正則和最長字符串會優先匹配。
    }
}

[root@nginx ~]# nginx -t -c /etc/nginx/nginx.conf	#檢查配置文件
[root@nginx ~]# nginx -s reload				#重載配置文件

2.2 匹配測試

訪問：http://location.linuxds.com/，將匹配規則A：

訪問：http://location.linuxds.com/login，將匹配規則B：

訪問：http://location.linuxds.com/static/test.html，將匹配規則C：

訪問：http://location.linuxds.com/static/files/test.txt，將匹配規則D：

解釋：雖然也符合規則C，但基於最大匹配原則，因此優先選擇規則D。

訪問：http://location.linuxds.com/test.txt，將匹配規則E：

解釋：雖然也符合規則F，但正則中基於順序優先，因此優先選擇規則E。

訪問：http://location.linuxds.com/static/test.txt，將匹配規則C：

解釋：雖然也符合規則F，但基於匹配優先級^~ > ~,~*，因此優先選擇規則C。

訪問：http://location.linuxds.com/test.TXT，將匹配規則G：

解釋：規則E區分大小寫，規則F不區分大小寫，因此優先選擇規則F。

訪問：http://location.linuxds.com/image/test.txt，將匹配規則E：

解釋：雖然也符合規則Y，但基於正則匹配優先，因此優選選擇規則E。

訪問：http://location.linuxds.com/image/test.tiff，將匹配規則G：

解釋：沒有更高優先級的其他規則（正則或=），因此匹配規則G。

訪問：http://location.linuxds.com/work/1234，將匹配規則I：

解釋：如上除H之外所有規則都不匹配，所有的地址都以 / 開頭，所以這條規則將作為最后匹配規則。

參考：

http://www.zzvips.com/article/33760.html

https://juejin.im/post/5ce5e1f65188254159084141

http://www.zzvips.com/article/33760.html

https://www.nginx.cn/doc/standard/httpcore.html #官方參考

三 正則與判斷

參考：https://blog.csdn.net/weixin_33726943/article/details/86007331