如何在自定义错误处理器中使用 mysqli::$errno 来处理 MySQL 错误？

M66 2025-07-18

在 PHP 中，我们常常需要与数据库进行交互，尤其是使用 MySQL 数据库时，mysqli 扩展是非常常见的选择。然而，当我们遇到数据库连接错误或查询错误时，需要有合适的方式来处理这些错误。mysqli::$errno 是 mysqli 类中的一个重要属性，它返回与 MySQL 最后一次错误相关的错误代码。本文将介绍如何在自定义错误处理器中使用 mysqli::$errno 来处理 MySQL 错误。

1. 自定义错误处理器

PHP 提供了 set_error_handler() 函数来设置自定义的错误处理器。我们可以通过这个方法捕获和处理错误。在使用 mysqli 连接和查询 MySQL 数据库时，若发生错误，mysqli::$errno 可以帮助我们判断错误类型，并据此进行特定的错误处理。

2. 使用 mysqli::$errno 来捕获 MySQL 错误

mysqli::$errno 返回一个整数值，表示上一个 MySQL 操作的错误代码。如果没有错误发生，它将返回 0。若返回其他值，则表示发生了错误。结合自定义错误处理器，我们可以根据错误代码进行分类处理，例如：记录日志、显示错误信息或进行重试等操作。

3. 示例代码

下面是一个使用 mysqli::$errno 来处理 MySQL 错误的示例。我们将设置一个自定义错误处理器，并在数据库连接和查询中使用 mysqli::$errno 来检查错误。

<?php
// 设置自定义错误处理器
set_error_handler("customErrorHandler");

function customErrorHandler($errno, $errstr, $errfile, $errline) {
    // 检查 MySQL 错误代码
    if ($errno == E_USER_WARNING) {
        echo "MySQL Error [$errno]: $errstr\n";
    } else {
        echo "Error [$errno]: $errstr in $errfile on line $errline\n";
    }
}

// 创建数据库连接
$mysqli = new mysqli("localhost", "username", "password", "database_name");

// 检查连接是否成功
if ($mysqli->connect_errno) {
    trigger_error("Failed to connect to MySQL: " . $mysqli->connect_error, E_USER_WARNING);
    exit();
}

// 执行查询
$query = "SELECT * FROM non_existent_table";
$result = $mysqli->query($query);

// 检查查询是否成功
if (!$result) {
    trigger_error("MySQL Query Error: " . $mysqli->error, E_USER_WARNING);
}

// 关闭连接
$mysqli->close();
?>

4. 代码解析

在上面的代码中，我们首先使用 set_error_handler() 函数设置了一个名为 customErrorHandler 的自定义错误处理器。
如果 MySQL 连接失败（如数据库服务器不可用），会通过 mysqli->connect_errno 获取连接错误代码，并通过 trigger_error() 将错误信息传递给自定义错误处理器。
同样地，如果查询执行失败，我们可以通过 mysqli->error 获取错误信息，并触发一个警告（E_USER_WARNING），由自定义错误处理器捕获。
自定义错误处理器会打印错误代码和信息，帮助开发者定位问题。

5. 处理 MySQL 错误代码

mysqli::$errno 不仅能返回错误代码，还可以结合 MySQL 的错误代码文档，帮助我们定位具体问题。例如，如果错误代码是 1064，这意味着 SQL 语法错误；如果错误代码是 1045，这意味着数据库认证失败。

6. 替换 URL 域名

当你在代码中需要处理与 URL 相关的错误时，可以使用 mysqli::$errno 来捕获并替换 URL 中的域名。例如，如果你在代码中发现了与数据库操作相关的错误，并希望替换域名为 m66.net，你可以按以下方式修改 URL：

相关标签:
mysqli

mysqli::$errno