如何用mysqli_stmt::$error 構建一個自動錯誤日誌系統

gitbox 2025-05-19

在開發Web 應用程序時，處理數據庫操作時的錯誤日誌記錄是至關重要的，尤其是在大型項目中，錯誤的追踪和解決能夠大大提升系統的穩定性和用戶體驗。 PHP 中的mysqli擴展提供了一個非常有用的功能， mysqli_stmt::$error ，可以幫助我們輕鬆捕捉數據庫操作中的錯誤並進行日誌記錄。

本文將介紹如何利用mysqli_stmt::$error函數構建一個自動錯誤日誌系統，並實時監控數據庫操作錯誤。通過這種方法，您可以確保在出現錯誤時，系統能夠迅速響應並記錄詳細的錯誤信息，便於後續的排查與修復。

1. 理解mysqli_stmt::$error函數

mysqli_stmt::$error是mysqli_stmt類的一個屬性，它用於返回最近一次mysqli_stmt查詢操作的錯誤信息。如果查詢執行成功，該屬性將為空。如果查詢出現錯誤，該屬性則會返回錯誤描述。通過這個屬性，我們可以捕捉到MySQL 執行語句時的錯誤信息。

 // 示例：使用 mysqli_stmt::$error 捕獲錯誤信息
if ($stmt->execute()) {
    echo "查詢成功！";
} else {
    echo "錯誤訊息: " . $stmt->error;
}

2. 構建自動錯誤日誌系統

為了自動記錄數據庫操作錯誤，您可以創建一個簡單的錯誤日誌系統，該系統將捕獲所有的數據庫操作錯誤並將其記錄到一個日誌文件中。下面是一個簡單的PHP 示例，展示如何使用mysqli_stmt::$error來捕捉並記錄數據庫錯誤：

 <?php

// 創建數據庫連接
$mysqli = new mysqli("localhost", "username", "password", "database");

// 檢查連接是否成功
if ($mysqli->connect_error) {
    die("連接失敗: " . $mysqli->connect_error);
}

// 函數：記錄錯誤到日誌文件
function log_error($message) {
    $logFile = '/path/to/log/error_log.txt'; // 日誌文件路徑
    $date = date("Y-m-d H:i:s");
    $logMessage = "[$date] - $message\n";
    file_put_contents($logFile, $logMessage, FILE_APPEND);
}

// 準備 SQL 查詢
$query = "SELECT * FROM users WHERE id = ?";
$stmt = $mysqli->prepare($query);

if ($stmt === false) {
    // 如果 SQL 语句準備失败，記錄錯誤
    log_error("SQL 準備失败: " . $mysqli->error);
    die("SQL 錯誤: " . $mysqli->error);
}

// 绑定参数并执行查詢
$id = 1;
$stmt->bind_param("i", $id);

if (!$stmt->execute()) {
    // 如果查詢执行失败，記錄錯誤
    log_error("查詢执行失败: " . $stmt->error);
    die("查詢失败: " . $stmt->error);
}

// 獲取結果並處理
$result = $stmt->get_result();
if ($result->num_rows > 0) {
    // 輸出數據
    while ($row = $result->fetch_assoc()) {
        echo "用戶ID: " . $row["id"] . " - 姓名: " . $row["name"] . "<br>";
    }
} else {
    echo "沒有找到數據";
}

// 關閉語句和數據庫連接
$stmt->close();
$mysqli->close();

?>

代碼說明：

數據庫連接：使用new mysqli()連接到數據庫，並檢查連接是否成功。
日誌記錄函數： log_error()函數將錯誤信息追加到指定的日誌文件中。
SQL 查詢執行：通過prepare()準備SQL 查詢， bind_param()綁定參數，執行execute() ，並在執行失敗時使用mysqli_stmt::$error記錄錯誤信息。
輸出結果：如果查詢成功，則輸出結果；如果沒有數據返回，則顯示"沒有找到數據"。

3. 實時監控數據庫操作錯誤

為了能夠實時監控數據庫操作中的錯誤，我們可以將錯誤信息寫入一個日誌文件，並且可以通過定時檢查日誌文件來獲取實時的錯誤信息。以下是一個使用PHP 讀取錯誤日誌並在前端展示錯誤消息的示例。

示例：實時監控錯誤日誌

<?php

// 實時讀取日誌文件
function get_recent_errors($logFile) {
    $errors = file_get_contents($logFile);
    return nl2br($errors); // 將換行符轉換為 HTML 換行
}

$logFile = '/path/to/log/error_log.txt';
$recentErrors = get_recent_errors($logFile);

echo "<h2>最近的数据库操作錯誤：</h2>";
echo "<pre>$recentErrors</pre>";

?>

代碼說明：

讀取日誌文件：通過file_get_contents()讀取日誌文件的內容。
顯示錯誤信息：將日誌中的內容顯示到頁面上，通過nl2br()函數將換行符轉換為HTML <br>標籤，使其更易讀。

4. 總結

通過上述方法，您可以輕鬆地使用PHP 中的mysqli_stmt::$error函數捕捉和記錄數據庫操作中的錯誤。結合自動錯誤日誌系統和實時監控，您可以及時發現並修復數據庫操作中的問題。這不僅能夠提高開發效率，還能在生產環境中幫助您快速響應系統異常。

在實際開發中，您可以根據需要進一步擴展該系統，如通過郵件通知開發者、使用數據庫記錄錯誤信息等。