Nginx + PHP-FPM 架構下,靜態頁正常、PHP 頁面回傳 HTTP 200 但內容空白,無任何錯誤日誌。問題在於 Nginx 預設的 fastcgi_params 不包含 SCRIPT_FILENAME,導致 PHP-FPM 無法定位腳本檔案。
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;
}
編輯 /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
若加上參數仍空白,檢查:
www-data/php-fpm)對腳本檔案有讀取權限。open_basedir 未限制腳本路徑。display_errors=Off 且 error_log 無寫入權限,導致錯誤被吞沒(建議開發環境開啟 display_errors=On)。