萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

Nginx + PHP 正確配置指南:避開常見陷阱與最佳實踐

許多開發者在配置 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 指令應放在 server 層級

在錯誤配置中,index 定義在 location / 內部:

location / {
    index index.html index.htm index.php;
}

一旦未來新增其他 location,勢必重複定義 index。因為多個 location 是平級關係,不存在繼承,正確做法是將 index 定義在 server 層級,藉由繼承機制讓所有 location 共用。

濫用 if 指令

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。

fastcgi_params vs fastcgi.conf

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。

安全隱患:cgi.fix_pathinfo

當 PHP 開啟 cgi.fix_pathinfo 時,可能將錯誤文件類型解析為 PHP。若 Nginx 與 PHP 部署在同一伺服器,最簡單的防禦是在 location ~ .php$ 中加入:

try_files $uri =404;

參考Nginx 文件類型錯誤解析漏洞。

改良後的配置版本

綜合上述分析,給出優化版本:

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 兼容性不足,解決方案較醜陋,有興趣者可自行研究。

copyright © 萬盛學電腦網 all rights reserved