如何通過mysqli::get_warnings 獲取最近一次操作的警告信息

gitbox 2025-06-03

在PHP 中使用MySQL 數據庫時，我們經常會關注查詢是否成功執行，但有時候查詢雖然執行成功，卻可能伴隨著警告信息，比如數據截斷、字段類型不匹配等。這些警告信息往往被忽略，但實際上它們對於排查問題、優化數據庫操作非常有用。

PHP 的mysqli擴展提供了一個方法get_warnings() ，專門用來獲取最近一次數據庫操作產生的警告信息。本文將詳細介紹這個方法的使用場景和具體用法，幫助你更好地捕獲和處理數據庫警告。

什麼是mysqli::get_warnings？

mysqli::get_warnings()是mysqli類的一個方法，用於返回一個mysqli_warning對象，該對象包含最近一次數據庫操作產生的所有警告。通過遍歷這個對象，你可以獲取每條警告的錯誤代碼和詳細信息。

這個方法特別適合用於那些雖然執行成功但存在潛在問題的SQL 語句，例如插入或更新時數據被截斷、使用了不完全匹配的字段類型，或者執行了某些MySQL 功能但返回了非致命的警告。

如何使用mysqli::get_warnings()

下面用一個簡單的例子演示mysqli::get_warnings()的使用。假設你向一個定義了長度限制的字符串字段插入了超長數據，會觸發警告。

 <?php
// 連接數據庫
$mysqli = new mysqli('gitbox.net', 'username', 'password', 'testdb');

if ($mysqli->connect_errno) {
    die("連接失敗: " . $mysqli->connect_error);
}

// 創建示例表
$mysqli->query("CREATE TABLE IF NOT EXISTS test_warning (
    id INT AUTO_INCREMENT PRIMARY KEY,
    name VARCHAR(5)
)");

// 插入超長字符串，觸發警告
$mysqli->query("INSERT INTO test_warning (name) VALUES ('超過長度的字符串測試')");

// 獲取警告資訊
$warnings = $mysqli->get_warnings();

if ($warnings) {
    do {
        printf("警告代碼: %d, 資訊: %s\n", $warnings->errno, $warnings->message);
    } while ($warnings->next());
} else {
    echo "无警告資訊。\n";
}

// 關閉連接
$mysqli->close();
?>

以上代碼中：

我們插入了一個超過字段長度限制的字符串，MySQL 會執行插入但會截斷字符串，產生警告。
使用$mysqli->get_warnings()獲取警告對象。
通過循環調用$warnings->next() ，遍歷所有警告並輸出詳細信息。

什麼時候使用mysqli::get_warnings()

數據插入或更新時警告檢查<br> 當你對數據的有效性有嚴格要求時，警告信息能幫你發現潛在的數據丟失或格式錯誤問題
調試複雜的SQL 操作<br> 某些複雜的查詢或存儲過程可能返回警告，利用這個方法可以幫助調試
日誌記錄與監控<br> 自動抓取警告寫入日誌，輔助運維人員及時發現數據庫異常

總結

mysqli::get_warnings()是一個非常實用的工具，幫助你捕獲並處理那些不影響操作結果但可能影響數據質量的警告。合理利用它，可以讓你的應用更加健壯和穩定。

想了解更多PHP 和MySQL 結合使用的技巧，可以訪問https://gitbox.net獲取最新的教程和示例。