中文(繁體)
中文(繁體)
在開發PHP 應用時，我們經常會與數據庫進行交互。使用mysqli擴展時， mysqli::$errno和mysqli::$error是非常常見的用來捕捉數據庫錯誤的重要工具。然而，很多開發者可能會誤解mysqli::$errno的用途，將其僅僅看作是一個用來檢查數據庫連接錯誤的工具。這種誤解會讓排查問題變得更加複雜，特別是在出現錯誤時。本文將詳細分析如何正確使用mysqli::$errno ，避免常見的誤解。
mysqli::$errno是一個mysqli對象的屬性，用來存儲上一個MySQL 操作的錯誤代碼。如果上一個操作成功執行， mysqli::$errno的值將為0 ，否則它會返回一個非零的錯誤碼。
需要注意的是， mysqli::$errno不僅僅適用於數據庫連接錯誤，還適用於所有通過mysqli執行的SQL 查詢操作。
<?php
// 創建數據庫連接
$mysqli = new mysqli("localhost", "user", "password", "database");
// 檢查連接
if ($mysqli->connect_errno) {
echo "連接失敗: " . $mysqli->connect_error;
exit();
}
// 執行查詢
$query = "SELECT * FROM non_existing_table";
$result = $mysqli->query($query);
// 檢查查詢是否成功
if (!$result) {
echo "查詢錯誤: " . $mysqli->error;
echo "錯誤代碼: " . $mysqli->errno; // 獲取錯誤碼
}
$mysqli->close();
?>
在這段代碼中， mysqli::$errno將返回查詢錯誤的錯誤碼（如果存在），而mysqli::$error將提供關於錯誤的詳細信息。
有很多開發者錯誤地認為， mysqli::$errno只用於檢查數據庫連接時的錯誤。如果我們對mysqli::$errno進行誤解，可能會導致在排查其他問題時漏掉重要的錯誤信息。事實上， mysqli::$errno可以用於檢查查詢錯誤、更新錯誤、甚至是事務提交失敗等各種數據庫操作錯誤。
<?php
$mysqli = new mysqli("localhost", "user", "password", "database");
// 錯誤的假設：只檢查連接錯誤
if ($mysqli->connect_errno) {
echo "連接失敗: " . $mysqli->connect_error;
exit();
}
// 錯誤的做法：不檢查其他 SQL 錯誤
$query = "SELECT * FROM non_existing_table";
$mysqli->query($query);
// 此处没有檢查查詢是否成功，可能错过了查詢錯誤
$mysqli->close();
?>
上面的代碼中，開發者可能誤認為只需要關注連接錯誤，而忽略了對查詢錯誤的檢查。這樣做會導致在執行查詢時無法捕捉到數據庫中的其他問題。
為了避免上述的誤解，我們應該在進行每一個數據庫操作後，都檢查mysqli::$errno ，無論是連接操作，還是查詢、更新、刪除等數據庫操作。只有這樣，才能更早發現潛在的數據庫問題。
<?php
// 創建數據庫連接
$mysqli = new mysqli("localhost", "user", "password", "database");
// 檢查連接錯誤
if ($mysqli->connect_errno) {
echo "連接失敗: " . $mysqli->connect_error;
exit();
}
// 執行查詢
$query = "SELECT * FROM non_existing_table";
$result = $mysqli->query($query);
// 檢查查詢是否成功
if (!$result) {
echo "查詢錯誤: " . $mysqli->error;
echo "錯誤代碼: " . $mysqli->errno; // 获取查詢錯誤码
}
$mysqli->close();
?>
在上面的代碼中，我們不僅檢查了數據庫連接錯誤，還在查詢之後檢查了可能發生的查詢錯誤。這樣做可以確保我們捕捉到每一個環節中的問題，從而更高效地定位並解決問題。
為了更加清楚地理解mysqli::$errno返回的錯誤碼，我們可以查閱MySQL 的錯誤碼文檔。以下是幾個常見的錯誤碼示例：
1045 : "Access denied for user" — 用戶名或密碼錯誤
1146 : "Table doesn't exist" — 表不存在
1064 : "You have an error in your SQL syntax" — SQL 語法錯誤
了解這些錯誤碼有助於我們更好地解讀錯誤信息，快速定位問題。
mysqli::$errno主要是用來提供錯誤代碼，而mysqli::$error則返回詳細的錯誤描述。在實際排查問題時，通常需要將這兩個屬性結合使用，來全面了解數據庫操作失敗的原因。
<?php
$mysqli = new mysqli("localhost", "user", "password", "database");
if ($mysqli->connect_errno) {
echo "連接失敗: " . $mysqli->connect_error;
exit();
}
$query = "SELECT * FROM non_existing_table";
$result = $mysqli->query($query);
if (!$result) {
echo "查詢失敗: " . $mysqli->error . "<br>";
echo "錯誤代碼: " . $mysqli->errno;
}
$mysqli->close();
?>
通過同時輸出錯誤信息和錯誤代碼，我們可以更清晰地了解到問題的根源，並採取相應的措施進行修復。
mysqli::$errno是PHP 中非常重要的一個屬性，它不僅僅用於檢查數據庫連接錯誤，更廣泛地應用於所有的MySQL 操作中。為了避免誤解帶來的排查困惑，我們應該在每次數據庫操作後都檢查mysqli::$errno ，確保能夠及時捕捉到任何潛在的錯誤。正確地理解和使用mysqli::$errno ，可以讓我們在開發過程中更加高效地排查問題，減少bug 的出現。
