詳解Nginx的try_files指令

一、什麼是try_files

try_files指令是Nginx中用於尋找匹配請求中文件的指令，這個指令是非常重要的。

try_files指令的語法格式如下：

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

上述位置塊使用try_files指令來查找與請求中的URI匹配的文件，如果該文件不存在，則通過向URI添加’/’並嘗試在其後查找一個目錄來實現。最後，如果前兩個過程都失敗了，則Nginx將發起一個內部重定向到URI包含的PHP腳本，並將查詢字元串傳遞給它。

二、try_files的用法

1、正常使用方法

try_files指令通常與location塊一起使用來確定如何服務請求。它有兩個參數：第一個參數是要查找的文件或目錄，第二個參數是在無法找到第一個參數所確定的文件或目錄時要重定向到的URL。

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

上述代碼塊使用try_files指令來找到與請求中當前URI匹配的文件。如果該文件不存在，則Nginx將嘗試找到一個目錄。如果目錄也不存在，則重定向到index.php文件並將查詢字元串傳遞給它。

2、try_files與rewrite的區別

有時您可能不想向URI添加查詢參數以創建新的URL。在這種情況下，try_files指令是比rewrite指令更好的選擇。

location / {
    try_files $uri /404.html;
}

上述代碼塊僅查找當前URI的文件（沒有查詢參數）和/404.html。如果Nginx找不到這些文件，則顯示404錯誤頁面。

3、try_files與命名位置塊

位置塊常常被用來等待特定的請求，但是如果所有塊都有一些通用的配置，則可以使用命名位置塊。這些位置塊包含共享配置。

location @rewrites {
    rewrite ^/product/(.*)?$ /index.php?product=$1 last;
}

location / {
    try_files $uri $uri/ @rewrites;
}

上述代碼塊中，命名位置塊@rewrites包含來自請求的產品條目，並將其傳遞給index.php腳本進行進一步處理。

三、try_files的常見問題

1、try_files與開啟gzip

在Nginx中啟用gzip可能會導致401應答錯誤。這是因為Nginx無法處理壓縮文件的請求。相反，需要使用try_files指令將靜態文件解壓縮後提供給客戶端。

location / {
    try_files /path/$uri.gz /path/$uri /fallback.html;
    gunzip on;
}

2、try_files與alias的問題

在使用 alias 命令的位置塊時，try_files 命令可能會突然失效，無法找到文件而產生 404 錯誤，這是因為輸入到$uri 中的 非正則表達式的 URI 都是相對於 Web 伺服器的 根目錄(/) 的。

location /img/ {
    alias /var/www/img/;
    try_files $uri $uri/ /fallback.html;
}

在這種情況下，嘗試查找 /var/www/img/$uri，但是由於uri輸入中的 /img/ URI 是別名的一部分，因此 Nginx 將查找 /var/www/img/img/some-image.png。解決此問題的方法是使用root而不是alias：

location /img/ {
    root /var/www/;
    try_files $uri $uri/ /fallback.html;
}

總結

try_files指令是Nginx中非常重要的一個指令，它可以用於尋找HTTP請求中匹配的文件。try_files的使用方法有很多，可以與location塊一起使用來確定如何服務請求，也可以與rewrite指令區別使用，還可以與命名位置塊一起使用。