配置 Nginx + PHP-FPM 環境後,HTML 靜態頁正常,但 PHP 頁面一片空白,Nginx 回傳 200 OK,錯誤日誌也沒錯誤。這是經典的 SCRIPT_FILENAME 未正確傳遞給 PHP-FPM 導致。
Nginx 透過 FastCGI 協議將請求轉發給 PHP-FPM,必須告知 PHP-FPM 要執行的腳本絕對路徑。缺少 fastcgi_param SCRIPT_FILENAME 參數時,PHP-FPM 不知道執行哪個檔案,直接回傳空內容(無錯誤)。
location ~ \.php$ {
root /var/www/html; # 你的網站根目錄
fastcgi_pass 127.0.0.1:9000; # PHP-FPM 監聽位址
fastcgi_index index.php;
# 關鍵:告知 PHP-FPM 腳本絕對路徑
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
$document_root:對應 root 指令路徑。$fastcgi_script_name:請求中的 PHP 腳本路徑(如 /index.php)。/var/www/html/index.php。若不想在每個 location 重複,可編輯 /etc/nginx/fastcgi_params(或 fastcgi.conf),確保包含:
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_param QUERY_STRING $query_string;
fastcgi_param REQUEST_METHOD $request_method;
fastcgi_param CONTENT_TYPE $content_type;
fastcgi_param CONTENT_LENGTH $content_length;
# ... 其他標準參數
然後在 location 中直接 include fastcgi_params; 即可。
nginx -s reloadphpinfo.php,應正常顯示 PHP 資訊頁。補充: 若 PHP-FPM 與 Nginx 不在同一台機器,$document_root 需對應 PHP-FPM 端的檔案系統路徑(掛載共享儲存或同步程式碼)。