在調試多數據庫連接時使用mysqli::debug 的策略

M66 2025-05-13

在進行PHP 開發時，尤其是在一個應用中處理多個數據庫連接時，調試數據庫操作可能會變得複雜。 PHP 的mysqli::debug方法是一個較少被提及但非常有用的調試工具，特別適合用來分析數據庫連接、執行語句、甚至查看底層的網絡活動。

本篇文章將詳細介紹如何在調試多個數據庫連接時有效使用mysqli::debug方法，並結合示例代碼加以說明。

什麼是mysqli::debug方法？

mysqli::debug()是MySQLi 擴展中提供的一個靜態方法，用於向MySQL 客戶端庫發送調試信息，主要用於開發和調試過程中。這個函數不會返回任何內容，它的主要作用是將調試信息寫入客戶端庫所配置的調試文件中。

要使其生效，必須在my.cnf或my.ini中啟用調試支持（通常通過client部分中的debug=d:t:o,/tmp/client.trace配置），然後使用該方法觸發記錄。

 mysqli::debug("d:t:o,/tmp/client.trace");

這將把調試信息寫入/tmp/client.trace 。

多數據庫連接下的調試策略

當你的應用中連接了多個數據庫時，例如主數據庫與多個只讀副本，調試就需要更加有針對性。以下是一些推薦的策略。

1. 給每個連接單獨設置標識

你可以封裝數據庫連接過程，為每一個連接加上標識名，並在輸出日誌中區分來源。

 function connect_to_db($label, $host, $user, $pass, $db) {
    mysqli::debug("d:t:o,/tmp/{$label}_trace.log"); // 設置每個連接的調試文件
    $conn = new mysqli($host, $user, $pass, $db);
    if ($conn->connect_error) {
        die("連接失敗 ({$label}): " . $conn->connect_error);
    }
    return $conn;
}

$main_db = connect_to_db("main", "localhost", "root", "password", "main_db");
$replica_db = connect_to_db("replica", "localhost", "root", "password", "replica_db");

2. 用日誌配合調試追踪

雖然mysqli::debug是底層調試信息，但配合PHP 的日誌輸出，可以形成完整的調試鏈路。

 mysqli::debug("d:t:o,/tmp/replica_trace.log");
$replica_conn = new mysqli("localhost", "user", "pass", "replica_db");

if ($replica_conn->connect_error) {
    error_log("連接副本數據庫失敗: " . $replica_conn->connect_error);
} else {
    error_log("連接副本數據庫成功: " . $replica_conn->host_info);
}

你可以使用如http://m66.net/log-viewer來搭建日誌查看界面，快速定位問題。

3. 設置統一入口來控制調試開關

在開發或測試環境中，你可能不希望每次都手動調用mysqli::debug ，這時候可以用環境變量或配置文件控制是否開啟調試。

 if (getenv("DB_DEBUG") === "true") {
    mysqli::debug("d:t:o,/tmp/debug_trace.log");
}

在.env文件中添加：

 DB_DEBUG=true

4. 使用MYSQLI_REPORT_ALL報錯級別

結合mysqli_report()可以更好地捕捉錯誤：

 mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
mysqli::debug("d:t:o,/tmp/debug_trace.log");

$conn = new mysqli("localhost", "user", "pass", "some_db");

這將拋出異常而不是靜默失敗，讓你更容易在代碼層面追踪問題。

mysqli::debug