許多開發者在配置 Nginx + PHP 時,習慣直接搜尋教程然後複製貼上。雖然這聽起來很便捷,但網路上流傳的資料往往年久失修、漏洞百出,若不求甚解地盲目套用,遲早會為此付出代價。
假設我們採用 PHP 實現前端控制器模式(統一入口),將所有 PHP 請求導向同一個文件,並透過解析 REQUEST_URI 實現路由。許多教程會建議如下配置:
server {
listen 80;
server_name foo.com;
root /path;
location / {
index index.html index.htm index.php;
if (!-e $request_filename) {
rewrite . /index.php last;
}
}
location ~ .php$ {
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME /path$fastcgi_script_name;
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
}
}
這段配置存在多個錯誤或壞味道,我們逐一分析。
Nginx 配置文件分為多層塊,常見由外而內依序為 http、server、location 等。預設繼承關係是由外向內,內層塊會自動獲取外層塊的值作為預設值(有例外情況,詳見官方文檔)。
在錯誤配置中,index 定義在 location / 內部:
location / {
index index.html index.htm index.php;
}
一旦未來新增其他 location,勢必重複定義 index。因為多個 location 是平級關係,不存在繼承,正確做法是將 index 定義在 server 層級,藉由繼承機制讓所有 location 共用。
if 是 Nginx 中最被誤解的指令:
if (!-e $request_filename) {
rewrite . /index.php last;
}
這其實是 try_files 指令的職責,應改寫為:
try_files $uri $uri/ /index.php;
初學者常以為 if 是核心級指令,實際上它屬於 rewrite 模組。Nginx 配置本質是聲明式而非過程式,當 if 與非 rewrite 模組指令混用時,結果往往出乎意料。參考IfIsEvil與How nginx "location if" works。
Nginx 提供兩份 FastCGI 配置文件:fastcgi_params 與 fastcgi.conf,兩者差異極小,唯一區別在於後者多了一行 SCRIPT_FILENAME 定義:
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
注意變數之間沒有斜線。早期只有 fastcgi_params,後來發現許多人硬編碼定義 SCRIPT_FILENAME,為規範用法才引入 fastcgi.conf。原因在於 fastcgi_param 是陣列型指令:同級多次使用時會新增而非替換,若重複定義會導致兩個值都傳給後端,引發潛在問題。參考FASTCGI_PARAMS VERSUS FASTCGI.CONF。
當 PHP 開啟 cgi.fix_pathinfo 時,可能將錯誤文件類型解析為 PHP。若 Nginx 與 PHP 部署在同一伺服器,最簡單的防禦是在 location ~ .php$ 中加入:
try_files $uri =404;
綜合上述分析,給出優化版本:
server {
listen 80;
server_name foo.com;
root /path;
index index.html index.htm index.php;
location / {
try_files $uri $uri/ /index.php;
}
location ~ \.php$ {
try_files $uri =404;
include fastcgi.conf;
fastcgi_pass 127.0.0.1:9000;
}
}
此版本更簡潔、安全。補充說明:location 已限定 .php$,故 fastcgi_index 實際上已無必要。另有一已知瑕疵:try_files 與 fastcgi_split_path_info 兼容性不足,解決方案較醜陋,有興趣者可自行研究。