mysqli_stmt::prepare 的 MySQL 错误码如何获取？

gitbox 2025-06-07

在使用 PHP 的 mysqli 扩展进行数据库操作时，mysqli_stmt::prepare 是预处理 SQL 语句的重要方法。预处理语句可以提高安全性和效率，但在执行 prepare 过程中，如果 SQL 语句存在错误，了解如何获取具体的 MySQL 错误码对于调试非常关键。本文将详细介绍如何获取 mysqli_stmt::prepare 执行时产生的 MySQL 错误码及相关步骤。

1. 了解 mysqli_stmt::prepare

mysqli_stmt::prepare 方法用于预处理一条 SQL 语句。它返回一个布尔值，表示预处理是否成功。如果失败，可以通过相关属性或方法获取错误信息和错误码。

$stmt = $mysqli->stmt_init();
if (!$stmt->prepare("YOUR SQL HERE")) {
    // 预处理失败
}

2. 获取错误码的属性和方法

mysqli_stmt 对象提供了两个关键的成员来获取错误信息：

$stmt->errno：获取错误码（error number）
$stmt->error：获取错误描述（error message）

此外，还可以通过连接对象 $mysqli 来获取全局错误码和信息。

3. 具体步骤示例代码

下面是一段示范代码，展示如何调用 prepare，并在失败时获取错误码和错误信息。

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

// 检查连接是否成功
if ($mysqli->connect_errno) {
    die("连接失败，错误码: " . $mysqli->connect_errno . "，错误信息: " . $mysqli->connect_error);
}

// 初始化预处理语句对象
$stmt = $mysqli->stmt_init();

// 预处理 SQL 语句（这里故意写错以触发错误）
$sql = "SELEC * FROM users"; // 错误的 SQL，SELECT 拼写错误

if (!$stmt->prepare($sql)) {
    echo "预处理失败！" . PHP_EOL;
    echo "错误码: " . $stmt->errno . PHP_EOL;
    echo "错误信息: " . $stmt->error . PHP_EOL;
} else {
    echo "预处理成功！" . PHP_EOL;
}

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

4. 说明

在上面代码中，故意将 SELECT 拼写为 SELEC，prepare 方法会返回 false。
通过 $stmt->errno 和 $stmt->error 获取详细的错误码和错误描述。
连接失败时则用 $mysqli->connect_errno 和 $mysqli->connect_error 获取错误信息。

5. 总结

获取 mysqli_stmt::prepare 执行过程中产生的 MySQL 错误码主要依赖于 mysqli_stmt 对象的 errno 属性。配合 error 属性可以快速定位问题，便于调试。推荐每次调用 prepare 后都检测返回值，并在失败时立即读取错误码与错误信息。

mysqli_stmt::prepare