開發 PHP 專案時,頁面一片空白、沒有任何錯誤提示,甚至連語法錯誤都不顯示。這通常是因為 php.ini 中關閉了錯誤顯示,或程式碼中被刻意抑制。
; php.ini
display_errors = On
display_startup_errors = On
; 開發環境建議:回報所有錯誤(含 Notice、Deprecated、Strict)
error_reporting = E_ALL
; 生產環境建議:隱藏 Notice 與 Deprecated,避免洩露敏感資訊
; error_reporting = E_ALL & ~E_NOTICE & ~E_DEPRECATED & ~E_STRICT
log_errors = On
error_log = /var/log/php/php_error.log
; 確保目錄存在且 PHP 執行使用者有寫入權限
# Apache
sudo systemctl restart apache2
# 或
sudo service httpd restart
# Nginx + PHP-FPM
sudo systemctl restart php-fpm
sudo systemctl restart nginx
在 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') — 關閉顯示找到後移除或註解即可恢復錯誤顯示。
安裝 Xdebug 擴充並配合 IDE(VS Code、PhpStorm)可實現:斷點、變數檢視、呼叫堆疊、程式碼覆蓋率分析。
<?php
// 快速除錯
var_dump($variable);
print_r($array);
// 或寫入日誌
error_log(print_r($data, true));
?>
<?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_errors | On | Off | Off |
| display_startup_errors | On | Off | Off |
| error_reporting | E_ALL | E_ALL | E_ALL & ~E_NOTICE & ~E_DEPRECATED |
| log_errors | On | On | On |
| error_log | 指定路徑 | 指定路徑 | 指定路徑 |
php --ini 或 phpinfo() 查看 Loaded Configuration File),且重啟的是正確的 PHP-FPM/Apache 服務。error_reporting 等級是否包含該錯誤類型(如 E_NOTICE 預設不在 E_ALL 中)。PHP 不顯示錯誤通常是設定問題。開發階段務必開啟 display_errors 與 E_ALL,生產環境則關閉顯示、開啟日誌記錄。善用 ini_set() 可快速在程式碼層面切換除錯模式,配合 Xdebug 可大幅提升除錯效率。