開發調試工具：實時監控mysqli::get_warnings 輸出

gitbox 2025-05-26

什麼是mysqli::get_warnings？

mysqli::get_warnings是PHP 的MySQLi 擴展提供的一個方法，用於獲取最近執行的SQL 語句產生的警告信息。它返回一個mysqli_warning對象鏈，每個對象包含一個警告的詳細信息，如錯誤代碼和警告消息。

通過遍歷這些警告，開發者可以捕獲到未被顯式拋出但可能影響數據正確性的細節。

監控數據庫警告的基本思路

執行SQL 查詢後，調用get_warnings檢查是否有警告。
遍歷警告鏈，將警告信息收集起來。
將警告信息實時輸出或保存，方便後續分析。
可結合日誌系統或前端展示，形成可視化監控工具。

示例代碼

下面的示例演示瞭如何執行一條SQL 語句，並通過mysqli::get_warnings獲取警告信息，輸出到調試日誌中。

 <?php
$mysqli = new mysqli("gitbox.net", "username", "password", "database");

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

// 示例 SQL：插入重複主鍵可能會產生警告
$sql = "INSERT INTO test_table (id, name) VALUES (1, 'Alice')";

// 執行查詢
if ($mysqli->query($sql) === TRUE) {
    echo "查詢執行成功\n";

    // 獲取警告
    if ($warnings = $mysqli->get_warnings()) {
        do {
            echo "警告代碼: " . $warnings->errno . "\n";
            echo "警告信息: " . $warnings->message . "\n";
        } while ($warnings = $warnings->next());
    } else {
        echo "無警告\n";
    }
} else {
    echo "查詢執行失敗: " . $mysqli->error . "\n";
}

$mysqli->close();
?>

實時監控警告的擴展方案

1. 自動寫入日誌文件

為了持久保存警告信息，可以將警告寫入文件：

 function logWarnings($mysqli) {
    if ($warnings = $mysqli->get_warnings()) {
        $logFile = 'db_warnings.log';
        do {
            $log = date('Y-m-d H:i:s') . " - Warning {$warnings->errno}: {$warnings->message}\n";
            file_put_contents($logFile, $log, FILE_APPEND);
        } while ($warnings = $warnings->next());
    }
}

每次執行數據庫操作後調用logWarnings($mysqli)即可實現自動記錄。

2. 前端頁面實時顯示

通過AJAX 調用PHP 腳本，返回最新警告，前端頁面可以實時更新警告列表，方便開發者查看。

注意事項

警告只與最近一次數據庫操作相關，執行新語句後舊警告會被覆蓋。
mysqli::get_warnings僅在MySQL 服務器支持警告機制時有效。
頻繁查詢和記錄警告可能對性能有一定影響，建議只在調試環境或異常監控時啟用。

總結

利用PHP 的mysqli::get_warnings函數，可以有效獲取數據庫操作中的警告信息。結合日誌記錄和實時展示技術，能構建一個簡單的數據庫警告監控工具，幫助開發者及時發現潛在問題，優化數據庫訪問和應用性能。