萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 常見編譯錯誤訊息解析與除錯技巧

前言

PHP 編譯器報錯訊息往往讓初學者困惑:報錯行號可能不準、訊息晦澀難懂。理解編譯器運作機制、熟悉常見錯誤模式,能大幅縮短除錯時間。本文系統整理解析錯誤類型、成因與應對策略。

編譯器運作機制

PHP 採單通編譯:由上而下解析,遇到第一個語法錯誤即停止。因此:

  • 報錯行號往往是「編譯器發現不合法語法的位置」,而非真正錯誤發生位置。
  • 前一行遺漏分號、引號未閉合、大括號不匹配,常導致後續正常程式碼被誤報。

核心錯誤類型解析

1. Parse Error(解析錯誤)

Parse error: syntax error, unexpected T_IF in /path/script.php on line 10
  • unexpected T_XXX:編譯器在不該出現 T_XXX(如 T_IF、T_WHILE、T_FOR、T_FUNCTION)的位置遇到該 Token。
  • 典型成因:上一行缺少分號、字串引號未閉合、關鍵字當變數名使用($while = 10;)。

經典案例:遺漏分號導致誤報

<?php
$b = "somevalue"  // 第 2 行缺少分號
if ($b == "somevalue") {  // 第 4 行被報錯:unexpected T_IF
    print "Hello world!";
}
?>

編譯器讀完第 2 行以為語句未結束,繼續吞吐 Token,直到第 4 行遇到 if 才發現語法無法銜接,故報錯在第 4 行。

2. 大括號不匹配

function UselessFunction() {
    for ($i = 0; $i < 10; $i++) {
    }
// 缺少函數結束的 }

報錯:Parse error: syntax error, unexpected $end in ... on line 9(檔案結尾)。

編譯器一路尋找匹配的 } 直到 EOF。良好的縮排習慣能讓此類錯誤一眼可見。

3. MySQL 資源錯誤

Warning: mysqli_fetch_array() expects parameter 1 to be mysqli_result, bool given in ...

真相:$result 為 false,表示查詢失敗。原因通常是:

  • SQL 語法錯誤(複製到資料庫客戶端直接執行驗證)。
  • 連線失敗(帳號密碼、主機、埠號錯誤)。
  • 資料表/欄位不存在。

正確寫法:

$result = $mysqli->query($sql);
if (!$result) {
    throw new Exception("Query failed: " . $mysqli->error);
}
while ($row = $result->fetch_assoc()) { ... }

預防策略:良好習慣消滅 80% 錯誤

  1. 每行結尾務必加分號,養成肌肉記憶。
  2. 縮排對齊:用 Tab 維護層級結構,大括號對齊,缺漏立現。
  3. 使用語法高亮編輯器(VS Code、PhpStorm、Sublime Text),引號、括號顏色配對一目瞭然。
  4. 開啟錯誤回報:開發環境設定 error_reporting(E_ALL); ini_set('display_errors', 1);。
  5. 善用版本控制:每次小幅提交,出錯時 git diff 秒鎖定變更。

結語

錯誤訊息是編譯器的「求救信號」,而非懲罰。掌握「報錯行 ≠ 錯誤行」的核心認知,配合結構化編碼習慣,PHP 除錯將不再是噩夢。

copyright © 萬盛學電腦網 all rights reserved