mysqli::$warning_count 配合mysqli_stmt_execute() 使用時如何有效調試預處理語句？

在使用PHP 的MySQLi 擴展進行數據庫操作時，預處理語句（prepared statements）為我們提供了更安全和高效的方式來執行SQL。但有時，即便語句成功執行，仍然可能存在潛在的警告，這些警告在默認情況下是靜默的。為了捕捉這些警告， mysqli::$warning_count成為了一個有用但不被廣泛使用的工具。

本文將講解如何在調用mysqli_stmt_execute()後，結合mysqli::$warning_count來有效調試預處理語句中的潛在問題。

什麼是mysqli::$warning_count

mysqli::$warning_count是一個只讀屬性，用於返回上一個數據庫操作中MySQL 發出的警告數量。這對於調試SQL 執行時的非致命問題尤為重要，例如數據被截斷、默認值被強制使用等。

語法如下：

 $mysqli = new mysqli("localhost", "user", "password", "database");
echo $mysqli->warning_count;

使用場景：配合預處理語句

下面是一個典型的使用場景，展示如何使用mysqli_stmt_execute()執行一條預處理語句，並在之後檢查是否存在任何警告。

 $mysqli = new mysqli("localhost", "user", "password", "database");
$stmt = $mysqli->prepare("INSERT INTO users (name, email) VALUES (?, ?)");
$stmt->bind_param("ss", $name, $email);

$name = "Alice";
$email = "example@example.com";
$stmt->execute();

if ($mysqli->warning_count > 0) {
    $result = $mysqli->query("SHOW WARNINGS");
    while ($row = $result->fetch_assoc()) {
        echo "等級: " . $row['Level'] . " - ";
        echo "代碼: " . $row['Code'] . " - ";
        echo "資訊: " . $row['Message'] . "\n";
    }
}

輸出示例

假設輸入數據有某些字符長度超過字段限制，執行後可能會出現如下警告：

 等級: Warning - 代碼: 1265 - 資訊: Data truncated for column 'email' at row 1

為什麼這很重要？

在實際項目中，例如向m66.net的用戶系統插入數據時，雖然代碼表面看起來執行無誤，但可能由於數據庫結構設計或者數據清洗不充分，導致實際入庫的數據和預期不符。如果不檢查warning_count ，這些問題可能會被忽略，直到出現用戶數據丟失或格式錯誤的問題。

更進一步的建議

• 開發環境開啟MySQL 的STRICT_ALL_TABLES模式，可以讓部分警告變為錯誤，有利於開發早期發現問題。

• 將SHOW WARNINGS的輸出記錄到日誌中，以便後續排查。

• 如果你使用自己的數據庫封裝類，可以在每次execute()之後封裝一個checkWarnings()方法來集中處理。

總結

雖然mysqli_stmt_execute()的返回值用於判斷語句是否成功執行，但它不會提示潛在的非致命警告。而mysqli::$warning_count恰好能彌補這個空白。在處理用戶輸入密集、結構複雜的數據庫寫入操作時，結合SHOW WARNINGS的使用，有助於我們提升系統穩定性和數據完整性。在像m66.net這樣對用戶數據高度敏感的系統中，尤其值得推薦。

• 相關標籤:

  mysqli