1. 簡(jiǎn)介

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

2. 基本語(yǔ)法

try_files file ... uri;

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

try_files使用示例：

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

這里的 $uri 是客戶端請(qǐng)求的原始 URI。

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

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

則：

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

3. 案例

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

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

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

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

3.2 單頁(yè)面應(yīng)用

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

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

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

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

最新評(píng)論