PHP 錯誤信息深度解讀：從 Parse Error 到 MySQL Warning 避坑指南

為什麼錯誤行號往往「對不上」？

PHP 編譯器採用「單次通過」解析：讀取文件 → 詞法分析 → 語法分析 → 生成 opcode。遇到第一個語法錯誤即停止，報錯位置是編譯器「發現不對勁」的位置，而非真正錯誤位置。

經驗法則：報錯行號往往是真實錯誤的後一行或後幾行。

經典案例：漏掉分號導致「莫名其妙」的 T_IF

<?php
$b = "somevalue"  // 第 2 行：漏掉分號
if ($b == "somevalue") { // 第 3 行
    print "Hello world!";
}
?>

報錯： Parse error: unexpected T_IF on line 3

原因： 編譯器讀完第 2 行以為語句未結束，繼續吞噬 token，直到第 3 行看到 if (T_IF) 這個「不應出現在表達式中」的關鍵字才報錯。

高頻錯誤模式速查表

MySQL 錯誤排查黃金三步

<?php
// ❌ 錯誤寫法：不檢查返回值
$res = mysqli_query($link, $sql);
$row = mysqli_fetch_assoc($res); // Warning 如果 $res 為 false

// ✅ 正確寫法：防御性編程
$res = mysqli_query($link, $sql);
if (!$res) {
    error_log('SQL Error: ' . mysqli_error($link) . ' | SQL: ' . $sql);
    // 返回友好錯誤或拋出異常
    throw new RuntimeException('Database query failed');
}
$row = mysqli_fetch_assoc($res);
?>

預防勝於治療：開發習慣清單

1. 語句強制分號結尾 —— 即使最後一行、即使單行代碼塊。
2. 縮進 = 邏輯結構 —— 使用 4 空格，IDE 自動格式化 (PSR-12)，缺少 } 一眼可見。
3. 語法高亮編輯器 —— VS Code + PHP Intelephense、PhpStorm，實時紅線提示。
4. 開啟嚴格報錯 —— 開發環境 error_reporting(E_ALL)、display_errors=On、log_errors=On。
5. 靜態分析工具 —— PHPStan (Level 5+)、Psalm、Rector，CI 流程強制跑過。

調試心法

• 二分法定位：註釋一半代碼，縮小範圍。
• 變量快照：var_dump($var); die; 或 debug_print_backtrace()。
• Xdebug 斷點調試：告別 echo 大法，單步執行、觀察變量、調用棧一目瞭然。

總結

PHP 錯誤信息看似神秘，實則遵循「編譯器視角」邏輯。養成規範縮進、防御性檢查返回值、善用靜態分析與 Xdebug 三大習慣，調試效率可提升 80% 以上。記住：報錯行號是線索，不是答案。