PHP 遇到**致命錯誤** (Fatal Error、Parse Error) 時,若**錯誤顯示關閉**,會直接輸出空內容 (HTTP 200/500 但 Body 為空)。這是生產環境預設行為 (安全),開發環境必須開啟顯示。
; 開發環境
display_errors = On
display_startup_errors = On
error_reporting = E_ALL
log_errors = On
error_log = /var/log/php_errors.log
; 生產環境
display_errors = Off
display_startup_errors = Off
error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT
log_errors = On
error_log = /var/log/php_errors.log
修改後必須重啟 PHP-FPM / Apache。
<?php
// 放在文件**最頂部**,任何輸出之前
ini_set('display_errors', '1');
ini_set('display_startup_errors', '1');
error_reporting(E_ALL);
// 或者
error_reporting(-1); // 所有錯誤
?>
注意:`parse error` (語法錯誤) 發生在編譯階段,`ini_set` 不會生效,**必須改 `php.ini`**。
php_flag display_errors on
php_value error_reporting 32767
# nginx.conf location ~ \.php$ {
fastcgi_param PHP_VALUE "display_errors=1\nerror_reporting=-1";
# }
**「Echo 大法」/ 二分法定位**:在關鍵節點輸出標記,縮小錯誤範圍。
<?php
echo "Checkpoint 1: Script start\n"; // 或 error_log()
$action = $_GET['id'] ?? '';
echo "Checkpoint 2: Got id=$action\n";
if ($action === '') {
$action = 1;
echo "Checkpoint 3: Set default action=1\n";
}
if ($action == 1) {
echo "Checkpoint 4: Enter action 1 branch\n";
// 疑似問題代碼區塊
require 'some_file.php'; // 可能這裡語法錯誤/致命錯誤
echo "Checkpoint 5: After require\n";
} elseif ($action == 2) {
echo "Checkpoint 4b: Enter action 2 branch\n";
}
echo "Checkpoint 6: Script end\n";
?>
瀏覽器查看輸出,**最後一條 Checkpoint 之後的代碼即為問題區**。
<?php
// 僅允許特定 IP 臨時開啟顯示 (極度謹慎,事後立即移除)
$allowedIPs = ['1.2.3.4', '127.0.0.1'];
if (in_array($_SERVER['REMOTE_ADDR'], $allowedIPs)) {
ini_set('display_errors', '1');
error_reporting(E_ALL);
}
?>