錯誤類型速查
| 類型 | 嚴重度 | 腳本行為 | 常見原因 |
| E_PARSE | 致命 | 停止編譯 | 語法錯誤:少分號、括號不對、保留字誤用 |
| E_ERROR | 致命 | 停止執行 | 呼叫未定義函式、類別不存在、記憶體耗盡 |
| E_WARNING | 非致命 | 繼續執行 | include 失敗、除以零、資源操作失敗 |
| E_NOTICE | 提示 | 繼續執行 | 未定義變數、陣列鍵不存在、靜態存取非靜態屬性 |
| E_DEPRECATED | 提示 | 繼續執行 | 使用棄用功能(如 each()、create_function()) |
| E_STRICT | 提示 | 繼續執行 | 編碼標準建議(覆寫方法簽名不相容等) |
Parse Error 為何指向錯誤行?
<?php
$b = "value" // 第 2 行漏分號
if ($b == "value") { // 第 3 行
echo "ok";
}
// 錯誤訊息:Parse error: syntax error, unexpected 'if' (T_IF) in ... on line 3
?>
**原因**:編譯器在第 2 行結束前看不出錯,讀到第 3 行 if 才發現前一陳述式未結束。實際錯誤常在報錯行之前。
常見錯誤模式與修正
| 錯誤訊息 | 真正原因 | 修正 |
| unexpected '}' / unexpected end of file | 少右大括號、少 ?> | 對齊縮排、IDE 括號配對檢查 |
| Call to undefined function mysql_connect() | PHP 7+ 移除 mysql_* | 改用 mysqli 或 PDO |
| Allowed memory size exhausted | 記憶體不足 | 分批處理、Generator、調大 memory_limit |
| Maximum execution time exceeded | 逾時 | set_time_limit(0)、Queue 非同步處理 |
| Headers already sent | 輸出前有空白/echo | 檢查 |
現代除錯工具鏈
- Xdebug 3:斷點、堆疊追蹤、效能分析(
xdebug.mode=debug,profile)
- Laravel Telescope / Symfony Profiler:請求生命週期、查詢、快取、隊列視覺化
- Sentry / Rollbar:生產環境例外追蹤、用戶影響範圍、版本關聯
- PHPStan / Psalm:靜態分析,上線前攔截型別錯誤、未定義變數、死代碼
錯誤處理最佳實務
<?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/error.log');
error_reporting(E_ALL & ~E_DEPRECATED & ~E_STRICT);
// 自訂例外處理器
set_exception_handler(function(Throwable $e) {
http_response_code(500);
error_log($e->getMessage() . "\n" . $e->getTraceAsString());
echo '系統維護中,請稍後再試。';
});