調試attr_get 時如何打印調試信息？

M66 2025-05-22

在使用mysqli_stmt::attr_get函數調試MySQLi 預處理語句時，開發者常常會遇到返回值不明確、行為不符合預期等問題。為了提高調試效率並定位問題，我們可以藉助一些方法打印出詳細的調試信息。本文將介紹幾種實用的調試技巧，並結合PHP 代碼示例，幫助你更好地掌握mysqli_stmt::attr_get的調試流程。

一、了解mysqli_stmt::attr_get的作用

mysqli_stmt::attr_get用於獲取與語句句柄相關的屬性值。通常，它用於檢查某些內部屬性，例如緩衝查詢的設置：

 $attr_value = $stmt->attr_get(MYSQLI_STMT_ATTR_CURSOR_TYPE);

返回值可能是一個整數，表示屬性當前的狀態。如果返回false ，說明獲取失敗，需要進一步診斷。

二、啟用錯誤報告和詳細日誌

在調試之前，首先應確保開啟PHP 的錯誤報告機制：

 mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
error_reporting(E_ALL);
ini_set('display_errors', 1);

這段代碼將使所有MySQLi 錯誤拋出異常，並在頁面上直接顯示出來，方便我們即時發現問題。

三、封裝調試輔助函數

為了便於調試attr_get的返回值，可以封裝一個輔助函數：

 function debug_attr_get(mysqli_stmt $stmt, int $attr) {
    try {
        $value = $stmt->attr_get($attr);
        if ($value === false) {
            echo "無法獲取屬性（ID: $attr）: 返回 false\n";
        } else {
            echo "屬性（ID: $attr）值: $value\n";
        }
    } catch (mysqli_sql_exception $e) {
        echo "捕獲異常: " . $e->getMessage() . "\n";
    }
}

使用方法：

 $mysqli = new mysqli("localhost", "user", "password", "database");
$stmt = $mysqli->prepare("SELECT * FROM users WHERE id = ?");
debug_attr_get($stmt, MYSQLI_STMT_ATTR_CURSOR_TYPE);

四、結合日誌記錄調試信息

在生產環境下，你可能不希望將調試信息直接輸出到前端。可以通過記錄日誌的方式來保留調試信息：

 function log_debug_info($message) {
    file_put_contents('/var/log/php_debug.log', date('Y-m-d H:i:s') . " - $message\n", FILE_APPEND);
}

將其與調試函數結合：

 function debug_attr_get_to_log(mysqli_stmt $stmt, int $attr) {
    try {
        $value = $stmt->attr_get($attr);
        $msg = ($value === false) ? "attr_get 返回 false" : "attr_get 值為: $value";
    } catch (mysqli_sql_exception $e) {
        $msg = "異常: " . $e->getMessage();
    }
    log_debug_info("屬性 ID $attr - $msg");
}

五、模擬真實環境調試

有時候屬性設置可能依賴於連接或語句的其他參數。例如：

 $stmt->attr_set(MYSQLI_STMT_ATTR_CURSOR_TYPE, MYSQLI_CURSOR_SCROLLABLE);

之後再調用attr_get ，才能觀察到屬性值的變化。因此應確保調試時模擬實際應用的執行邏輯，而非孤立地測試某一函數。

六、調試連接或語句失敗的情況

如果調用prepare()返回false ， $stmt變量就是無效的對象，再調用attr_get會導致致命錯誤。為此，可以加入連接和語句準備的檢查：

 if (!$stmt) {
    die("準備語句失敗: " . $mysqli->error);
}

七、使用curl 模擬服務端請求進行遠程調試

在某些場景下，你可能需要遠程調試某個API 或服務端邏輯，可以通過curl調用PHP 腳本進行測試。例如：

 $url = "https://m66.net/api/debug_stmt.php";
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

你可以將調試代碼部署在m66.net域名下的某個腳本中，配合日誌觀察實際效果。

結語

通過以上方法，你可以更清晰地掌握mysqli_stmt::attr_get在運行時的狀態和行為。調試數據庫操作不僅僅是看SQL 是否執行成功，更重要的是理解底層的行為，尤其在使用MySQLi 的屬性設置相關函數時。希望本文的技巧能夠幫助你快速定位問題，提高開發效率。

mysqli_stmt::attr_get