錯誤層級常數對照表
| 值 | 常數 | 說明 |
| 1 | E_ERROR | 致命運行時錯誤,腳本終止 |
| 2 | E_WARNING | 運行時警告,腳本繼續 |
| 4 | E_PARSE | 編譯時語法解析錯誤 |
| 8 | E_NOTICE | 運行時提示(如未定義變數),不中斷 |
| 16 | E_CORE_ERROR | PHP 核心啟動致命錯誤 |
| 32 | E_CORE_WARNING | PHP 核心啟動警告 |
| 64 | E_COMPILE_ERROR | 編譯時致命錯誤 |
| 128 | E_COMPILE_WARNING | 編譯時警告 |
| 256 | E_USER_ERROR | 用戶觸發錯誤 |
| 512 | E_USER_WARNING | 用戶觸發警告 |
| 1024 | E_USER_NOTICE | 用戶觸發提示 |
| 2048 | E_STRICT | 編碼標準建議(PHP 5+) |
| 4096 | E_RECOVERABLE_ERROR | 可捕獲致命錯誤(PHP 5.2+) |
| 8192 | E_DEPRECATED | 棄用功能警告(PHP 5.3+) |
| 16384 | E_USER_DEPRECATED | 用戶觸發棄用警告 |
| 32767 | E_ALL | 所有錯誤(PHP 5.4+ 含 E_STRICT) |
三層配置優先級(由高到低)
- 腳本內
error_reporting():運行時動態覆蓋,僅影響當前腳本。
- Apache
httpd.conf / .htaccess:php_value error_reporting 2039,覆蓋 php.ini,影響虛擬主機/目錄。
php.ini:全域預設值。
常見配置範例
1. 腳本內動態設定
<?php
// 僅顯示錯誤、警告、解析錯誤(隱藏 Notice)
error_reporting(E_ERROR | E_WARNING | E_PARSE); // 值 7
// 開發環境:顯示所有錯誤含 Strict
error_reporting(E_ALL);
// 生產環境:隱藏所有顯示,但記錄日誌
error_reporting(E_ALL);
ini_set('display_errors', '0');
ini_set('log_errors', '1');
ini_set('error_log', '/var/log/php_errors.log');
?>
2. php.ini 設定
; 開發環境
display_errors = On
error_reporting = E_ALL & ~E_NOTICE & ~E_STRICT & ~E_DEPRECATED
; 生產環境
display_errors = Off
error_reporting = E_ALL & ~E_NOTICE & ~E_STRICT & ~E_DEPRECATED
log_errors = On
error_log = /var/log/php_errors.log
3. Apache httpd.conf / .htaccess
# 開發環境
php_flag display_errors On
php_value error_reporting 32767 ; E_ALL (含 E_STRICT)
# 生產環境
php_flag display_errors Off
php_value error_reporting 30719 ; E_ALL & ~E_NOTICE & ~E_STRICT & ~E_DEPRECATED (PHP 5.4+)
# 或 2039 (舊版 E_ALL & ~E_NOTICE)
位元運算技巧
E_ALL & ~E_NOTICE:開啟所有,關閉 Notice。
E_ALL ^ E_NOTICE:切換 Notice 狀態(若原本開啟則關閉,反之亦然)。
E_ERROR | E_WARNING | E_PARSE:僅啟用嚴重錯誤(值 7)。
PHP 7/8 新增層級
| 常數 | 值 | 說明 |
| E_THROWABLE | - | 所有可拋出異常的基礎(內部使用) |
| E_DEPRECATED | 8192 | 已在 5.3 列出 |
PHP 8 將大量 Warning 提升為 Error(如未定義變數、除以零),建議生產環境至少保留 E_ERROR | E_WARNING | E_PARSE。
最佳實踐建議
- 開發機:
error_reporting(E_ALL); ini_set('display_errors', '1');
- 測試/預發:同開發,但開啟日誌記錄。
- 生產環境:
display_errors=0、log_errors=1、error_reporting=E_ALL & ~E_NOTICE & ~E_DEPRECATED,並配置日誌輪轉與告警。