為什麼mysqli_stmt::attr_get 獲取不到屬性值？

M66 2025-05-20

在使用PHP 的MySQLi 擴展時， mysqli_stmt::attr_get函數用於獲取預處理語句對象的屬性值。然而，很多開發者會遇到調用該函數時無法正確獲取到屬性值的問題。本文將深入分析這一現象的可能原因，並給出相應的解決方案。

一、 mysqli_stmt::attr_get的作用和使用場景

mysqli_stmt::attr_get方法用於獲取指定的預處理語句屬性，通常這些屬性是通過mysqli_stmt::attr_set設置的。常見的屬性包括：

MYSQLI_STMT_ATTR_UPDATE_MAX_LENGTH
MYSQLI_STMT_ATTR_CURSOR_TYPE
MYSQLI_STMT_ATTR_PREFETCH_ROWS

舉個簡單的示例：

 $mysqli = new mysqli('m66.net', 'user', 'password', 'database');

$stmt = $mysqli->prepare("SELECT * FROM users WHERE id = ?");
$stmt->attr_set(MYSQLI_STMT_ATTR_CURSOR_TYPE, MYSQLI_CURSOR_TYPE_READ_ONLY);

$cursorType = $stmt->attr_get(MYSQLI_STMT_ATTR_CURSOR_TYPE);
echo "Cursor Type: " . $cursorType;

如果一切正常， $cursorType應該能返回設置的游標類型值。

二、為什麼無法獲取到屬性值？

屬性未被正確設置
attr_get只能獲取到通過attr_set已經設置的屬性值。如果屬性從未被設置， attr_get會返回false或無法預期的值。
部分屬性只支持寫入不支持讀取 某些屬性是只寫的， attr_get無法讀取到它們的值，導致返回無效
MySQLi 驅動版本限製或bug
不同版本的PHP 和MySQLi 驅動對於屬性的支持不完全相同，某些版本中attr_get可能存在實現缺陷。
錯誤的屬性常量或類型 調用時傳入的屬性常量如果不是有效的MYSQLI_STMT_ATTR_ * ，會導致無法讀取

三、解決辦法

確保屬性已經設置 調用attr_get之前，要確認對應屬性已經用attr_set正確設置過例如：

 $stmt->attr_set(MYSQLI_STMT_ATTR_PREFETCH_ROWS, 10);
$value = $stmt->attr_get(MYSQLI_STMT_ATTR_PREFETCH_ROWS);

檢查PHP 和MySQLi 版本 確認你使用的PHP 版本和MySQLi 擴展是最新的，或者至少支持你想使用的屬性升級PHP 版本通常可以解決兼容性問題。
避免讀取只寫屬性 查閱官方文檔確認目標屬性是否支持讀取，避免讀取只寫屬性
使用錯誤處理和調試信息 調用attr_get後，檢查返回值並使用mysqli_stmt_error來捕獲錯誤信息，幫助定位問題

$value = $stmt->attr_get(MYSQLI_STMT_ATTR_CURSOR_TYPE);
if ($value === false) {
    echo "Failed to get attribute: " . $stmt->error;
}

使用替代方案 如果需要確認某些屬性的狀態，可以考慮通過程序邏輯或查詢數據庫服務器參數來替代直接讀取屬性

四、總結

mysqli_stmt::attr_get在使用中受限於屬性是否已經設置、PHP/MySQLi 版本及屬性本身的讀寫特性。出現無法獲取屬性值時，首先要確認屬性已經被設置，且所用版本支持讀取該屬性。此外，合理的錯誤處理和版本升級也是排查和解決問題的關鍵。