萬盛學電腦網

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

Nginx 回傳 200 但 PHP 頁面空白:fastcgi.conf 缺失 SCRIPT_FILENAME 解決方案

Nginx + PHP-FPM 架構下,靜態頁正常、PHP 頁面回傳 HTTP 200 但內容空白,無任何錯誤日誌。問題在於 Nginx 預設的 fastcgi_params 不包含 SCRIPT_FILENAME,導致 PHP-FPM 無法定位腳本檔案。

兩種修正位置

方法一:在 location 區塊直接加入(推薦,明確優先)

location ~ \.php$ {
    root           html;
    fastcgi_pass   127.0.0.1:9000;
    fastcgi_index  index.php;
    # 關鍵行:指定腳本絕對路徑
    fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
    include        fastcgi_params;
}

方法二:修改 fastcgi_params 或使用 fastcgi.conf(全域生效)

編輯 /etc/nginx/fastcgi_params,加入:

# PHP 必需參數
fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
fastcgi_param  REDIRECT_STATUS  200;  # 若 PHP 編譯時啟用 --enable-force-cgi-redirect 需要

或直接使用已包含此參數的 fastcgi.conf:

include fastcgi.conf;  # 替代 include fastcgi_params;

完整最小可用範例

server {
    listen 80;
    server_name example.com;
    root /var/www/html;
    index index.php index.html;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass 127.0.0.1:9000;
        fastcgi_index index.php;
        include fastcgi.conf;  # 已含 SCRIPT_FILENAME
    }
}

重載生效

nginx -t && nginx -s reload

延伸:PHP-FPM 權限問題也會導致空白

若加上參數仍空白,檢查:

  • PHP-FPM 執行用戶(www-data/php-fpm)對腳本檔案有讀取權限。
  • open_basedir 未限制腳本路徑。
  • PHP display_errors=Off 且 error_log 無寫入權限,導致錯誤被吞沒(建議開發環境開啟 display_errors=On)。
copyright © 萬盛學電腦網 all rights reserved