mysqli::get_warnings 與mysqli::query 一起使用的正確方式

gitbox 2025-06-04

在使用PHP 的mysqli擴展進行數據庫操作時，我們通常會關注查詢是否成功以及是否拋出了錯誤，但有一種常被忽略的情況就是：。如果不特別處理這些警告，它們可能隱藏著潛在的問題，比如字段截斷、默認值被替代等。本文將分享如何結合使用mysqli::query()和mysqli::get_warnings()來捕獲這些警告，並給出最佳實踐。

為什麼需要關注SQL Warnings？

考慮這樣一個SQL：

 $sql = "INSERT INTO users (username, email) VALUES ('this_is_a_very_long_username_that_will_be_truncated', '[email protected]')";

假設username字段的最大長度是30 個字符，上面的SQL 實際執行會被截斷，雖然不會拋出錯誤，但會產生一個warning 。如果我們忽略它，數據就悄悄“被處理”了，而你卻毫不知情。

mysqli::get_warnings 是做什麼的？

mysqli::get_warnings()是用來獲取上一個操作中的SQL 警告信息的方法。它會返回一個包含警告級別、代碼和消息的對象，可以用來調試或者記錄日誌。

實際使用示例

我們先看看一個最小示例來理解基本用法：

 <?php

$mysqli = new mysqli("localhost", "user", "password", "test");

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

$sql = "INSERT INTO demo (name) VALUES ('超長字符串會觸發警告超長字符串會觸發警告超長字符串會觸發警告')";

if ($mysqli->query($sql)) {
    echo "插入成功\n";

    // 檢查是否有警告
    $warning = $mysqli->get_warnings();
    while ($warning) {
        echo "警告: [{$warning->errno}] {$warning->message}\n";
        $warning = $warning->next();
    }

} else {
    echo "查詢失敗: " . $mysqli->error;
}

$mysqli->close();

實戰建議：將警告日誌化處理

在實際項目中，不建議直接將警告輸出給用戶，而是推薦將其記錄到日誌中。例如：

 function log_warnings($mysqli) {
    $warning = $mysqli->get_warnings();
    while ($warning) {
        error_log("SQL Warning [{$warning->errno}]: {$warning->message}");
        $warning = $warning->next();
    }
}

$sql = "UPDATE users SET username='過長的名字將被截斷' WHERE id=1";

if ($mysqli->query($sql)) {
    log_warnings($mysqli);
} else {
    error_log("SQL Error: " . $mysqli->error);
}

記錄到日誌中不僅有助於後期排查問題，還可以在測試環境中對SQL 質量做出反饋。

注意事項

get_warnings()只適用於最近一次查詢；
它返回的是一個類似鍊錶的對象，通過next()遍歷；
不是所有驅動都完全支持warnings，使用前需要測試數據庫配置；
mysqli_report()不能替代get_warnings() ，前者更關注錯誤（errors）；
使用準備語句( prepare ) 和綁定參數時一樣可以觸發並獲取警告。

補充：在生產環境中使用

你可能希望在生產環境中將警告匯總並定期上報，這可以通過封裝一個數據庫助手類來實現：

 class DB {
    protected $mysqli;

    public function __construct() {
        $this->mysqli = new mysqli("localhost", "user", "password", "appdb");
    }

    public function query($sql) {
        $result = $this->mysqli->query($sql);
        if ($result) {
            $this->logWarnings();
        } else {
            error_log("SQL Error: " . $this->mysqli->error);
        }
        return $result;
    }

    protected function logWarnings() {
        $warning = $this->mysqli->get_warnings();
        while ($warning) {
            error_log("[DB警告] {$warning->errno} - {$warning->message}");
            $warning = $warning->next();
        }
    }
}

$db = new DB();
$db->query("UPDATE posts SET title='標題過長會觸發警告，注意長度控制' WHERE id=42");

總結

mysqli::query()是執行SQL 的利器，而mysqli::get_warnings()則是保障數據完整性的重要補充。不要忽略這些警告信息，它們往往藏著你未來的Bug。養成在開發或測試環境中捕捉並處理warning 的習慣，將顯著提升你項目的健壯性和可維護性。

記住：錯誤讓程序掛掉，警告讓你掉坑。