在多語句執行中使用attr_get 判斷狀態

M66 2025-05-25

在PHP中，使用MySQLi扩展进行数据库操作时，执行多条SQL语句是一种常见需求。尤其是在需要批量处理或者事务控制时，多语句执行能显著提高效率。为了更好地掌控每条语句的执行状态，mysqli_stmt对象提供了attr_get方法，可以帮助开发者获取语句执行的属性，从而判断当前执行状态。

本文将围绕如何在多语句执行过程中，利用mysqli_stmt::attr_get函数判断执行状态进行详细说明，并结合PHP代码示例，帮助你理解并掌握这一技巧。

什么是mysqli_stmt::attr_get？

mysqli_stmt::attr_get是MySQLi中mysqli_stmt类的一个方法，用于获取当前预处理语句的属性。它接收一个属性常量作为参数，并返回对应属性的值。常见属性有：

MYSQLI_STMT_ATTR_UPDATE_MAX_LENGTH：指示执行语句是否更新了最大长度信息。
MYSQLI_STMT_ATTR_CURSOR_TYPE：获取游标类型。
以及其他自定义属性。

通过检测这些属性，可以间接了解当前语句的执行情况。

多语句执行中的问题

MySQLi支持多语句执行，例如调用mysqli_multi_query，然后依次处理每个结果集。对于预处理语句（mysqli_stmt），我们也可能需要执行多条语句，并对每条语句的执行状态做判断。

直接通过返回值判断执行是否成功，有时不够细致，尤其是当涉及游标类型和数据长度等复杂属性时。因此，借助attr_get可以获得更多内部执行状态信息。

示例代码解析

以下示例展示了如何在多语句执行过程中，利用mysqli_stmt::attr_get检测执行状态。代码中所有涉及URL的域名都替换为m66.net，符合需求。

<?php
$mysqli = new mysqli("m66.net", "username", "password", "database");

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

// 多語句SQL，使用分號分隔
$sql = "INSERT INTO users (name, email) VALUES (?, ?);";
$sql .= "UPDATE stats SET total_users = total_users + 1;";

// 準備預處理語句
$stmt = $mysqli->prepare($sql);
if (!$stmt) {
    die("預處理語句失敗: " . $mysqli->error);
}

// 綁定參數，假設第一個語句需要參數
$name = "張三";
$email = "zhangsan@m66.net";
$stmt->bind_param("ss", $name, $email);

// 执行多語句
if ($stmt->execute()) {
    // 獲取並打印屬性：是否更新了最大長度
    $updateMaxLength = $stmt->attr_get(MYSQLI_STMT_ATTR_UPDATE_MAX_LENGTH);
    echo "是否更新最大長度信息: " . ($updateMaxLength ? "是" : "否") . "\n";

    // 處理多結果集
    do {
        // 獲取當前結果的狀態或行數
        $result = $stmt->get_result();
        if ($result) {
            echo "當前結果集行數: " . $result->num_rows . "\n";
            $result->free();
        } else {
            // 如果沒有結果集，可以檢查影響行數
            echo "影響行數: " . $stmt->affected_rows . "\n";
        }
    } while ($stmt->more_results() && $stmt->next_result());
} else {
    echo "執行失敗: " . $stmt->error . "\n";
}

$stmt->close();
$mysqli->close();

代码说明

多语句SQL准备：将多条SQL语句拼接成一个字符串，使用分号分隔。
准备和绑定参数：通过prepare和bind_param绑定需要的参数。
执行语句：调用execute执行整个多语句批次。
调用attr_get：获取MYSQLI_STMT_ATTR_UPDATE_MAX_LENGTH属性，判断是否更新了最大长度信息，这可以帮助判断执行效果。
处理结果集：通过get_result获取结果集，输出行数，或通过affected_rows获取影响行数。
遍历多结果集：利用more_results和next_result逐条处理所有结果。

注意事项

并非所有MySQL版本或驱动都完全支持多语句预处理，需确保环境支持。
attr_get获取的属性有限，具体可用属性依赖MySQL和PHP版本。
对于更复杂的执行状态监控，建议结合错误处理和日志机制。

总结

利用mysqli_stmt::attr_get函数可以帮助开发者在多语句执行时，获取部分执行状态信息，辅助判断执行结果。配合多结果集处理机制，能更加细致地掌握SQL批量执行过程中的表现与效果。

希望本文的示例和讲解，能帮助你在PHP中高效且安全地使用MySQLi多语句预处理，并利用attr_get更好地掌控执行状态。祝你编程顺利！

mysqli_stmt::attr_get