PHP 錯誤類型與調試技巧全解析

PHP 錯誤的三大類別

1. 語法錯誤

代碼不符合 PHP 語法規則，腳本無法執行，直接拋出 Parse Error。

<?php
Echo 100.  // 缺少分號
Echo 100;
Echo 101;
?>
// Parse error: syntax error, unexpected ';'

2. 運行時錯誤

腳本能運行，但因邏輯或環境問題導致功能失效，輸出 Warning/Notice，不中止腳本。

<?php
echo "this is a demo";
header('Location: https://www.example.com/'); // header 前有輸出
?>
// Warning: Cannot modify header information - headers already sent

3. 邏輯錯誤

腳本正常運行且無報錯，但結果不符合預期，最難排查。

<?php
$a = 5;
if ($a = 6) {  // 應為 ==，這裡是賦值
    echo $a;   // 輸出 6
}
?>

錯誤報告級別

• ERROR：致命錯誤，腳本停止運行。
• WARNING：警告，腳本繼續運行。
• NOTICE：通知，如未定義變量，腳本繼續運行。

開發環境建議配置

<?php
// 顯示所有錯誤
error_reporting(E_ALL);
ini_set('display_errors', 1);

// 生產環境建議關閉顯示，記錄日誌
// ini_set('display_errors', 0);
// ini_set('log_errors', 1);
// ini_set('error_log', '/path/to/php-error.log');
?>

常用調試手段

• var_dump() / print_r()：檢查變量結構與值。
• debug_print_backtrace()：輸出調用堆疊。
• Xdebug：專業調試擴展，支持斷點、堆疊分析、性能分析。
• 錯誤日誌：生產環境必開啟 error_log。

異常處理

PHP 5+ 引入異常機制，可用 try-catch 捕獲可預期的運行時異常，配合自定義異常類實現優雅錯誤處理。

<?php
try {
    // 高風險操作
    if (!$conn = @mysqli_connect(...)) {
        throw new Exception('資料庫連接失敗');
    }
} catch (Exception $e) {
    error_log($e->getMessage());
    die('系統繁忙，請稍後再試');
}
?>