萬盛學電腦網

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

PHP 不顯示錯誤訊息?完整解決方案與除錯設定指南

問題現象

開發 PHP 專案時,頁面一片空白、沒有任何錯誤提示,甚至連語法錯誤都不顯示。這通常是因為 php.ini 中關閉了錯誤顯示,或程式碼中被刻意抑制。

解決方法一:修改 php.ini 設定(推薦,全域生效)

1. 開啟錯誤顯示

; php.ini
display_errors = On
display_startup_errors = On

2. 設定錯誤報告等級

; 開發環境建議:回報所有錯誤(含 Notice、Deprecated、Strict)
error_reporting = E_ALL

; 生產環境建議:隱藏 Notice 與 Deprecated,避免洩露敏感資訊
; error_reporting = E_ALL & ~E_NOTICE & ~E_DEPRECATED & ~E_STRICT

3. 錯誤記錄到日誌(生產環境必備)

log_errors = On
error_log = /var/log/php/php_error.log
; 確保目錄存在且 PHP 執行使用者有寫入權限

4. 重啟 Web 伺服器使設定生效

# Apache
sudo systemctl restart apache2
# 或
sudo service httpd restart

# Nginx + PHP-FPM
sudo systemctl restart php-fpm
sudo systemctl restart nginx

解決方法二:程式碼中動態設定(不需改 php.ini,立即生效)

在 PHP 檔案最開頭(或公共引入檔)加入:

<?php
// 開發環境:顯示所有錯誤
ini_set('display_errors', '1');
ini_set('display_startup_errors', '1');
error_reporting(E_ALL);

// 生產環境:不顯示錯誤,僅記錄日誌
// ini_set('display_errors', '0');
// ini_set('log_errors', '1');
// ini_set('error_log', '/var/log/php/php_error.log');
// error_reporting(E_ALL & ~E_NOTICE & ~E_DEPRECATED);
?>

解決方法三:檢查程式碼中是否被抑制

搜尋專案中是否存在以下抑制錯誤的寫法:

  • @ 前綴:@mysql_connect()、@fopen() — 會抑制該行錯誤訊息
  • error_reporting(0) — 關閉所有錯誤報告
  • ini_set('display_errors', '0') — 關閉顯示

找到後移除或註解即可恢復錯誤顯示。

進階除錯技巧

1. 使用 Xdebug 進行斷點除錯

安裝 Xdebug 擴充並配合 IDE(VS Code、PhpStorm)可實現:斷點、變數檢視、呼叫堆疊、程式碼覆蓋率分析。

2. 臨時輸出變數內容

<?php
// 快速除錯
var_dump($variable);
print_r($array);
// 或寫入日誌
error_log(print_r($data, true));
?>

3. 自定義錯誤處理器

<?php
set_error_handler(function($severity, $message, $file, $line) {
    if (!(error_reporting() & $severity)) return false;
    throw new ErrorException($message, 0, $severity, $file, $line);
});

set_exception_handler(function($e) {
    // 記錄日誌、發送通知、顯示友善錯誤頁
    error_log($e->getMessage() . ' in ' . $e->getFile() . ':' . $e->getLine());
    if (ini_get('display_errors')) {
        echo '<h1>系統錯誤</h1><pre>' . $e->getMessage() . '</pre>';
    } else {
        echo '<h1>系統維護中,請稍後再試</h1>';
    }
});
?>

環境別建議設定對照表

設定項目開發環境測試/Staging生產環境
display_errorsOnOffOff
display_startup_errorsOnOffOff
error_reportingE_ALLE_ALLE_ALL & ~E_NOTICE & ~E_DEPRECATED
log_errorsOnOnOn
error_log指定路徑指定路徑指定路徑

常見問題 QA

Q: 改了 php.ini 重啟後仍不顯示錯誤?
A: 確認修改的是正確的 php.ini(執行 php --ini 或 phpinfo() 查看 Loaded Configuration File),且重啟的是正確的 PHP-FPM/Apache 服務。
Q: 只有部分錯誤不顯示?
A: 檢查 error_reporting 等級是否包含該錯誤類型(如 E_NOTICE 預設不在 E_ALL 中)。
Q: 白畫面沒有任何輸出?
A: 可能是嚴重語法錯誤導致編譯失敗,查看 Web 伺服器錯誤日誌(/var/log/apache2/error.log 或 /var/log/nginx/error.log)或 PHP-FPM 日誌。

總結

PHP 不顯示錯誤通常是設定問題。開發階段務必開啟 display_errors 與 E_ALL,生產環境則關閉顯示、開啟日誌記錄。善用 ini_set() 可快速在程式碼層面切換除錯模式,配合 Xdebug 可大幅提升除錯效率。

copyright © 萬盛學電腦網 all rights reserved