用mysqli::get_warnings 和郵件系統構建異常通知服務

gitbox 2025-06-06

在PHP 中使用MySQL 數據庫時，除了捕獲錯誤外，有時還需要關注數據庫發出的警告信息。這些警告可能預示著潛在的問題，比如數據截斷、字段長度超出限制等。 mysqli::get_warnings函數可以幫助我們獲取這些警告信息，從而做進一步處理。

本文將介紹如何利用mysqli::get_warnings結合郵件系統，搭建一個簡單的異常通知服務。當數據庫操作產生警告時，自動將警告內容通過郵件發送給管理員，方便及時發現和處理潛在問題。

1. mysqli::get_warnings 簡介

mysqli::get_warnings是PHP 的mysqli 擴展中提供的一個方法，用於獲取最近一次數據庫操作產生的警告信息。

用法示例：

 $mysqli = new mysqli('gitbox.net', 'user', 'password', 'database');
$mysqli->query("INSERT INTO table_name (col) VALUES ('超長字符串...')");
if ($warnings = $mysqli->get_warnings()) {
    do {
        echo "Warning: ({$warnings->errno}) {$warnings->message}\n";
    } while ($warnings->next());
}

該方法返回一個mysqli_warning對象，包含errno （警告碼）、 message （警告信息）和next()方法用於遍歷所有警告。

2. 搭建異常通知服務的思路

執行數據庫操作後，調用get_warnings檢查是否有警告。
如果存在警告，收集所有警告信息。
通過郵件系統，將警告信息發送給預設的管理員郵箱。
在實際業務中，這個步驟可以集成在數據庫操作的封裝函數里，實現自動檢測與通知。

3. 代碼示例：結合郵件發送

以下示例演示如何在數據庫操作後檢測警告並發送郵件通知：

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

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

$sql = "INSERT INTO users (username) VALUES ('超出長度的用戶名示例……')";
$mysqli->query($sql);

$warnings = $mysqli->get_warnings();
if ($warnings) {
    $warningMessages = [];
    do {
        $warningMessages[] = "Warning ({$warnings->errno}): {$warnings->message}";
    } while ($warnings->next());

    $subject = "數據庫警告通知";
    $body = "以下是最近數據庫操作產生的警告信息：\n\n" . implode("\n", $warningMessages);
    $to = "[email protected]";
    $headers = "From: [email protected]";

    // 發送郵件
    if (mail($to, $subject, $body, $headers)) {
        echo "警告通知郵件已發送。";
    } else {
        echo "郵件發送失敗。";
    }
} else {
    echo "未檢測到數據庫警告。";
}

$mysqli->close();
?>

4. 進階建議

日誌記錄：除了發送郵件，建議將警告信息寫入日誌文件，方便後續審計和排查。
異步通知：若郵件發送可能阻塞業務流程，可以用隊列或異步任務處理郵件發送。
更多告警渠道：結合短信、微信等其他即時通知方式，提高告警響應速度。
異常封裝：封裝數據庫操作函數，統一捕獲錯誤與警告，避免重複代碼。