根目錄和索引文件

root 指令指定將用于搜索文件的根目錄。 為了獲取所請求文件的路徑，NGINX 將請求 URI 附加到 root 指令指定的路徑。該指令可以放在 http {} ， server {} 或 location {} 上下文中的任何級別。在下面的示例中，為虛擬服務(wù)器定義了 root 指令。 它適用于未包含根指令的所有 location {} 塊，以顯式重新定義根：

server {  root /www/data;  location / {  }  location /images/ {  }  location ~ /.(mp3|mp4) {    root /www/media;  }}

在這里，NGINX 針對 /images/ 開頭的 URI 將在文件系統(tǒng)的 /www/ data/images/ 目錄中搜索相應(yīng)文件。 如果 URI 以 .mp3 或 .mp4 擴展名結(jié)尾，則 NGINX 會在 /www/media/ 目錄中搜索該文件，因為它是在匹配的位置塊中定義的。

如果請求以 / 結(jié)尾，則 NGINX 將其視為對目錄的請求，并嘗試在目錄中查找索引文件。 index 指令定義索引文件的名稱（默認值為 index.html）。要繼續(xù)該示例，如果請求 URI 是 /images/some/path/ ，則 NGINX 會返回文件 /www/data/images/some/path/index.html （如果存在）。如果沒有，NGINX 默認返回 HTTP 404 錯誤（未找到）。要配置 NGINX 以返回自動生成的目錄列表，請在 autoindex 指令中包含 on 參數(shù)：

location /images/ {  autoindex on;}

你可以在 index 指令中列出多個文件名。 NGINX按指定的順序搜索文件并返回它找到的第一個文件。

location / {  index index.$geo.html index.htm index.html;}

這里使用的 $geo 變量是通過 geo 指令設(shè)置的自定義變量。變量的值取決于客戶端的 IP 地址。

要返回索引文件，NGINX 會檢查它是否存在，然后對通過將索引文件的名稱附加到基礎(chǔ) URI 上獲得的新 URI 進行內(nèi)部重定向。內(nèi)部重定向?qū)е聦ξ恢玫男滤阉?，并且可能最終位于另一個位置，如以下示例所示：

location / {  root /data;  index index.html index.php;}location ~ /.php {  fastcgi_pass localhost:8000;  #...}

這里，如果請求中的 URI 是 /path/ ，并且 /data/path/index.html 不存在但 /data/path/index.php 存在，則內(nèi)部重定向到 /path/index.php 將映射到第二個位置。結(jié)果，請求被代理。

嘗試幾種選擇

try_files 指令可用于檢查指定的文件或目錄是否存在; NGINX 會進行內(nèi)部重定向，如果沒有，則返回指定的狀態(tài)代碼。例如，要檢查對應(yīng)于請求 URI 的文件是否存在，請使用 try_files 指令和 $uri 變量，如下所示：

server {  root /www/data;  location /images/ {    try_files $uri /images/default.gif;  }}

該文件以 URI 的形式指定，使用在當(dāng)前位置或虛擬服務(wù)器的上下文中設(shè)置的根或別名指令進行處理。在這種情況下，如果對應(yīng)于原始 URI 的文件不存在，NGINX 會將內(nèi)部重定向到最后一個參數(shù)指定的 URI，并返回 /www/data/images/default.gif 。