PHP 編譯器報錯訊息往往讓初學者困惑:報錯行號可能不準、訊息晦澀難懂。理解編譯器運作機制、熟悉常見錯誤模式,能大幅縮短除錯時間。本文系統整理解析錯誤類型、成因與應對策略。
PHP 採單通編譯:由上而下解析,遇到第一個語法錯誤即停止。因此:
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 行。
function UselessFunction() {
for ($i = 0; $i < 10; $i++) {
}
// 缺少函數結束的 }
報錯:Parse error: syntax error, unexpected $end in ... on line 9(檔案結尾)。
編譯器一路尋找匹配的 } 直到 EOF。良好的縮排習慣能讓此類錯誤一眼可見。
Warning: mysqli_fetch_array() expects parameter 1 to be mysqli_result, bool given in ...
真相:$result 為 false,表示查詢失敗。原因通常是:
正確寫法:
$result = $mysqli->query($sql);
if (!$result) {
throw new Exception("Query failed: " . $mysqli->error);
}
while ($row = $result->fetch_assoc()) { ... }
error_reporting(E_ALL); ini_set('display_errors', 1);。git diff 秒鎖定變更。錯誤訊息是編譯器的「求救信號」,而非懲罰。掌握「報錯行 ≠ 錯誤行」的核心認知,配合結構化編碼習慣,PHP 除錯將不再是噩夢。