根據(jù)請求的URI設(shè)置配置集合付材。所有的匹配都是在解碼以后的娩鹉,相鄰的兩個/會被翻譯成一個/逾滥。
一個location規(guī)則可以是一個 前綴字符串(prefix string) 也可以是一個正則表達(dá)式(Regular expressions)
正則表達(dá)式由修飾符“ * ” 開頭(用于大小寫不敏感的匹配)掂榔,或者由修飾符“~”開頭(用于大小寫敏感的匹配)窒百。給一個請求去查找匹配的時候词裤,nginx首先檢查使用前綴字符串( prefix string )定義的規(guī)則刺洒。其中,所有匹配中的規(guī)則最長的一條會被確認(rèn)并標(biāo)記吼砂,繼續(xù)檢查正則表達(dá)式逆航,按照配置文件的順序檢查。當(dāng)有匹配的正則記錄以后立即停止渔肩,并立即使用該條配置因俐。如果沒有一條正則表達(dá)式被匹配到,則使用之前前綴字符串匹配到的配置周偎。
location 是可以嵌套使用的抹剩,除了下面提到的一些意外。
如果最長匹配前綴位置具有“^?”修飾符蓉坎,則不檢查正則表達(dá)式澳眷。
同樣,如果使用修飾符“=”可以做精確匹配蛉艾。完全匹配到規(guī)則钳踊,則停止搜索。舉例伺通,如果 “/”請求經(jīng)常發(fā)生箍土,可以定義“l(fā)ocation = /” 可以加速請求的處理速度,因?yàn)樗阉髟诘谝淮伪葘φ_以后會立即終止罐监。這樣的規(guī)則顯然不能被嵌套起來吴藻。
讓我們來舉一些例子:
location = / {
[ configuration A ]
}
location / {
[ configuration B ]
}
location /documents/ {
[ configuration C ]
}
location ^~ /images/ {
[ configuration D ]
}
location ~* \.(gif|jpg|jpeg)$ {
[ configuration E ]
}
"/"請求匹配A規(guī)則,"/index.html"請求匹配B規(guī)則弓柱,"/documents/document.html"請求匹配C規(guī)則沟堡, "/images/1.gif"請求匹配D規(guī)則侧但,"documents/1.jpg" 請求匹配規(guī)則E
指令作用匹配指定的請求uri(請求uri不包含查詢字符串,如http://localhost:8080/test?id=10航罗,請求uri是/test)語法形式location [ = | ~ | ~* | ^~ | @] /uri/ { configuration }匹配模式及順序匹配字符串分為兩種:普通字符串(literal string)和正則表達(dá)式(regular expression)禀横,其中 ~ 和 ~* 用于正則表達(dá)式, 其他前綴和無任何前綴都用于普通字符串粥血。匹配順序是:1柏锄、先匹配普通字符串,將最精確的匹配暫時存儲复亏;2趾娃、然后按照配置文件中的聲明順序進(jìn)行正則表達(dá)式匹配,只要匹配到一條正則表達(dá)式缔御,則停止匹配抬闷,取正則表達(dá)式為匹配結(jié)果;3耕突、如果所有正則表達(dá)式都匹配不上笤成,則取1中存儲的結(jié)果;4眷茁、如果普通字符串和正則表達(dá)式都匹配不上炕泳,則報404 NOT FOUND。location = /uri =開頭表示精確前綴匹配蔼卡,只有完全匹配才能生效喊崖。location ^~ /uri ^~開頭表示普通字符串匹配上以后不再進(jìn)行正則匹配挣磨。location ~ pattern ~開頭表示區(qū)分大小寫的正則匹配雇逞。location ~* pattern ~開頭表示不區(qū)分大小寫的正則匹配。location /uri 不帶任何修飾符茁裙,表示前綴匹配塘砸。location / 通用匹配,任何未匹配到其他location的請求都會匹配到晤锥。注意:正則匹配會根據(jù)匹配順序掉蔬,找到第一個匹配的正則表達(dá)式后將停止搜索。普通字符串匹配則無視順序矾瘾,只會選擇最精確的匹配女轿。常用配置指令alias、root壕翩、proxy_pass1蛉迹、alias——別名配置,用于訪問文件系統(tǒng)放妈,在匹配到location配置的URL路徑后北救,指向alias配置的路徑荐操,如:
location /test/ {
alias /usr/local/;
}
請求/test/1.jpg(省略了協(xié)議和域名),將會返回文件/usr/local/1.jpg珍策。如果alias配置在正則匹配的location內(nèi)托启,則正則表達(dá)式中必須包含捕獲語句(也就是括號()),而且alias配置中也要引用這些捕獲值攘宙。如:
location ~ /img/(.+.(gif|png|jpeg)) {
alias /usr/local/images/$1;
}
請求中只要能匹配到正則屯耸,比如/img/flower.png 或者 /resource/img/flower.png,都會轉(zhuǎn)換為請求/usr/local/images/flower.png蹭劈。2肩民、root——根路徑配置,用于訪問文件系統(tǒng)链方,在匹配到location配置的URL路徑后持痰,指向root配置的路徑,并把請求路徑附加到其后祟蚀,如:
location /test/ {
root /usr/local/;
}
請求/test/1.jpg工窍,將會返回文件/usr/local/test/1.jpg。3前酿、proxy_pass——反向代理配置患雏,用于代理請求,適用于前后端負(fù)載分離或多臺機(jī)器罢维、服務(wù)器負(fù)載分離的場景淹仑,在匹配到location配置的URL路徑后,轉(zhuǎn)發(fā)請求到proxy_pass配置額URL肺孵,是否會附加location配置路徑與proxy_pass配置的路徑后是否有"/"有關(guān)匀借,有"/"則不附加,如:
location /test/ {
proxy_pass http://127.0.0.1:8080/;
}
請求/test/1.jpg平窘,將會被nginx轉(zhuǎn)發(fā)請求到http://127.0.0.1:8080/1.jpg(未附加/test/路徑)吓肋。附:匹配規(guī)則