1. 簡介

try_files是Nginx中一個非常強(qiáng)大且常用的指令，其用于按順序檢查文件是否存在，并將請求傳遞給第一個找到的文件，或者在所有文件都未找到時，執(zhí)行一個回退URI。該指令在配置靜態(tài)網(wǎng)站或單頁面應(yīng)用（SPA）時特別有用，因?yàn)槠淇梢源_保Nginx優(yōu)先服務(wù)靜態(tài)文件，而只有在靜態(tài)文件不存在時才將請求轉(zhuǎn)發(fā)給后端應(yīng)用或提供回退頁面。

2. 基本語法

try_files file ... uri;

• file ... : 一個或多個要檢查的文件路徑。Nginx會按照提供的順序檢查這些文件是否存在；
• uri：若所有指定的文件都不存在，則執(zhí)行回退URI，該URI可以是一個靜態(tài)頁面（如404頁面），也可以是一個請求處理程序（如一個處理所有前端路由的PHP腳本或Node.js應(yīng)用的入口點(diǎn)）；

try_files使用示例：

try_files  $uri $uri/ /TEST/index.html;

這里的 $uri 是客戶端請求的原始 URI。

讓我們逐步解釋這條指令：

1）$uri: Nginx 會首先嘗試直接從請求的 URI 中查找文件。例如，如果用戶請求 /about, Nginx 會嘗試查找 /about 文件。
2）$uri/: 如果第一步?jīng)]有找到文件，Nginx 會嘗試將請求的 URI 視為目錄，并在后面添加斜杠 /。例如，如果用戶請求 /about, Nginx 會嘗試查找 /about/ 目錄。
3）/TEST/index.html: 如果前兩步都沒有成功找到文件或目錄，Nginx 會嘗試返回 /TEST/index.html 文件。

則：

• 如果用戶請求的是一個存在的文件（如 /about），Nginx 將直接返回該文件。
• 如果用戶請求的是一個目錄（如 /about/），Nginx 將嘗試返回該目錄下的默認(rèn)文件。
• 如果上述兩種情況都沒有發(fā)生，Nginx 最終會嘗試返回 /TEST/index.html。
• 這樣的配置非常適合單頁應(yīng)用（SPA）或那些希望為所有未找到的路由提供一個默認(rèn)頁面的應(yīng)用程序。例如，如果你有一個前端應(yīng)用托管在 /TEST/ 下，并且所有的頁面都在 /TEST/index.html 中呈現(xiàn)，那么這個配置就能確保無論用戶請求什么路徑，都能看到應(yīng)用的首頁。

3. 案例

3.1 靜態(tài)網(wǎng)站

假設(shè)有一個靜態(tài)網(wǎng)站，其HTML、CSS和JS文件都存放在/data/www目錄下，并希望Nginx首先嘗試直接服務(wù)這些靜態(tài)文件，若文件不存在，則返回404錯誤。

server {  
    listen       80;  
    server_name  example.com;  
  
    root   /data/www;  
  
    location / {  
        try_files $uri $uri/ =404;  
    }  
}

在該例子中，$uri表示請求的URI（不包括主機(jī)名和端口），若$uri指向的文件或目錄存在，Nginx將直接服務(wù)它，若$uri指向的文件不存在但目錄存在，Nginx會嘗試在末尾添加斜杠并重試請求，若仍未找到文件，則Nginx將返回404錯誤。

3.2 單頁面應(yīng)用

對于單頁面應(yīng)用，希望無論請求什么URL，都返回同一個HTML文件（通常是index.html）,然后讓前端路由處理這些URL，這可以通過將try_files指令的回退設(shè)置為該HTML文件來實(shí)現(xiàn)。

server {  
    listen       80;  
    server_name  myapp.com;  
  
    root   /usr/share/nginx/html;  
  
    location / {  
        try_files $uri $uri/ /index.html;  
    }  
}

該配置中，Nginx首先嘗試服務(wù)請求的文件或目錄，若找不到，則會回退到/index.html，這允許前端路由接管并顯示正確的頁面，這種方法特別適用于React、Vue或Angular等現(xiàn)代前端框架構(gòu)建的單頁面應(yīng)用。

到此這篇關(guān)于Nginx中try_files指令的實(shí)現(xiàn)示例的文章就介紹到這了,更多相關(guān)Nginx try_files指令內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論