萬盛學電腦網

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

Nginx + PHP-FPM 回傳空白頁面?缺少這行 fastcgi_param 設定

配置 Nginx + PHP-FPM 環境後,HTML 靜態頁正常,但 PHP 頁面一片空白,Nginx 回傳 200 OK,錯誤日誌也沒錯誤。這是經典的 SCRIPT_FILENAME 未正確傳遞給 PHP-FPM 導致。

問題原因

Nginx 透過 FastCGI 協議將請求轉發給 PHP-FPM,必須告知 PHP-FPM 要執行的腳本絕對路徑。缺少 fastcgi_param SCRIPT_FILENAME 參數時,PHP-FPM 不知道執行哪個檔案,直接回傳空內容(無錯誤)。

解決方法:在 Nginx 設定中加入 SCRIPT_FILENAME

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。

替代寫法:修改 fastcgi_params 檔案

若不想在每個 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; 即可。

驗證

  1. 重載 Nginx:nginx -s reload
  2. 訪問 phpinfo.php,應正常顯示 PHP 資訊頁。

補充: 若 PHP-FPM 與 Nginx 不在同一台機器,$document_root 需對應 PHP-FPM 端的檔案系統路徑(掛載共享儲存或同步程式碼)。

copyright © 萬盛學電腦網 all rights reserved