简体中文
简体中文
在开发 PHP 应用时，我们经常会与数据库进行交互。使用 mysqli 扩展时，mysqli::$errno 和 mysqli::$error 是非常常见的用来捕捉数据库错误的重要工具。然而，很多开发者可能会误解 mysqli::$errno 的用途，将其仅仅看作是一个用来检查数据库连接错误的工具。这种误解会让排查问题变得更加复杂，特别是在出现错误时。本文将详细分析如何正确使用 mysqli::$errno，避免常见的误解。
mysqli::$errno 是一个 mysqli 对象的属性，用来存储上一个 MySQL 操作的错误代码。如果上一个操作成功执行，mysqli::$errno 的值将为 0，否则它会返回一个非零的错误码。
需要注意的是，mysqli::$errno 不仅仅适用于数据库连接错误，还适用于所有通过 mysqli 执行的 SQL 查询操作。
<?php
// 创建数据库连接
$mysqli = new mysqli("localhost", "user", "password", "database");
// 检查连接
if ($mysqli->connect_errno) {
echo "连接失败: " . $mysqli->connect_error;
exit();
}
// 执行查询
$query = "SELECT * FROM non_existing_table";
$result = $mysqli->query($query);
// 检查查询是否成功
if (!$result) {
echo "查询错误: " . $mysqli->error;
echo "错误代码: " . $mysqli->errno; // 获取错误码
}
$mysqli->close();
?>
在这段代码中，mysqli::$errno 将返回查询错误的错误码（如果存在），而 mysqli::$error 将提供关于错误的详细信息。
有很多开发者错误地认为，mysqli::$errno 只用于检查数据库连接时的错误。如果我们对 mysqli::$errno 进行误解，可能会导致在排查其他问题时漏掉重要的错误信息。事实上，mysqli::$errno 可以用于检查查询错误、更新错误、甚至是事务提交失败等各种数据库操作错误。
<?php
$mysqli = new mysqli("localhost", "user", "password", "database");
// 错误的假设：只检查连接错误
if ($mysqli->connect_errno) {
echo "连接失败: " . $mysqli->connect_error;
exit();
}
// 错误的做法：不检查其他 SQL 错误
$query = "SELECT * FROM non_existing_table";
$mysqli->query($query);
// 此处没有检查查询是否成功，可能错过了查询错误
$mysqli->close();
?>
上面的代码中，开发者可能误认为只需要关注连接错误，而忽略了对查询错误的检查。这样做会导致在执行查询时无法捕捉到数据库中的其他问题。
为了避免上述的误解，我们应该在进行每一个数据库操作后，都检查 mysqli::$errno，无论是连接操作，还是查询、更新、删除等数据库操作。只有这样，才能更早发现潜在的数据库问题。
<?php
// 创建数据库连接
$mysqli = new mysqli("localhost", "user", "password", "database");
// 检查连接错误
if ($mysqli->connect_errno) {
echo "连接失败: " . $mysqli->connect_error;
exit();
}
// 执行查询
$query = "SELECT * FROM non_existing_table";
$result = $mysqli->query($query);
// 检查查询是否成功
if (!$result) {
echo "查询错误: " . $mysqli->error;
echo "错误代码: " . $mysqli->errno; // 获取查询错误码
}
$mysqli->close();
?>
在上面的代码中，我们不仅检查了数据库连接错误，还在查询之后检查了可能发生的查询错误。这样做可以确保我们捕捉到每一个环节中的问题，从而更高效地定位并解决问题。
为了更加清楚地理解 mysqli::$errno 返回的错误码，我们可以查阅 MySQL 的错误码文档。以下是几个常见的错误码示例：
1045: "Access denied for user" — 用户名或密码错误
1146: "Table doesn't exist" — 表不存在
1064: "You have an error in your SQL syntax" — SQL 语法错误
了解这些错误码有助于我们更好地解读错误信息，快速定位问题。
mysqli::$errno 主要是用来提供错误代码，而 mysqli::$error 则返回详细的错误描述。在实际排查问题时，通常需要将这两个属性结合使用，来全面了解数据库操作失败的原因。
<?php
$mysqli = new mysqli("localhost", "user", "password", "database");
if ($mysqli->connect_errno) {
echo "连接失败: " . $mysqli->connect_error;
exit();
}
$query = "SELECT * FROM non_existing_table";
$result = $mysqli->query($query);
if (!$result) {
echo "查询失败: " . $mysqli->error . "<br>";
echo "错误代码: " . $mysqli->errno;
}
$mysqli->close();
?>
通过同时输出错误信息和错误代码，我们可以更清晰地了解到问题的根源，并采取相应的措施进行修复。
mysqli::$errno 是 PHP 中非常重要的一个属性，它不仅仅用于检查数据库连接错误，更广泛地应用于所有的 MySQL 操作中。为了避免误解带来的排查困惑，我们应该在每次数据库操作后都检查 mysqli::$errno，确保能够及时捕捉到任何潜在的错误。正确地理解和使用 mysqli::$errno，可以让我们在开发过程中更加高效地排查问题，减少 bug 的出现。
