如何捕捉 $errno 并将错误上报至 Sentry 或其他监控工具

M66 2025-06-05

在开发 PHP 应用时，数据库错误是常见的异常之一，特别是在使用 mysqli 扩展进行数据库操作时，如何有效地捕捉这些错误并及时上报监控平台，可以帮助开发者更快地发现和解决问题。本文将介绍如何使用 mysqli::$errno 捕捉数据库错误，并将错误信息上报到 Sentry 或其他监控平台，确保您的系统保持稳定性和高效性。

1. 什么是 mysqli::$errno？

mysqli::$errno 是 mysqli 类中一个非常重要的属性，它用于获取上一次数据库操作的错误代码。如果操作成功，errno 会返回 0，如果发生了错误，则会返回对应的错误代码。通过这个属性，您可以轻松判断数据库操作是否成功。

2. 基本的 mysqli 错误捕捉方式

在进行数据库操作时，我们通常会进行错误检测，以便及时发现和处理异常。一个简单的示例如下：

<?php
$mysqli = new mysqli("localhost", "user", "password", "database");

if ($mysqli->connect_error) {
    echo "连接失败: " . $mysqli->connect_error;
    exit();
}

$query = "SELECT * FROM nonexistent_table";
$result = $mysqli->query($query);

if ($mysqli->errno) {
    echo "SQL 错误代码: " . $mysqli->errno . " 错误信息: " . $mysqli->error;
}
?>

上面的代码示例展示了如何在进行查询时使用 mysqli::$errno 来捕捉错误并输出相应的错误信息。

3. 将错误上报到 Sentry

Sentry 是一个流行的错误跟踪和监控平台，它可以帮助开发者实时捕捉并处理应用程序中的错误。为了将错误信息发送到 Sentry，首先需要安装 Sentry 的 SDK。

使用 Composer 安装 Sentry PHP SDK：

composer require sentry/sdk

然后，在您的代码中集成 Sentry 来上报错误，代码如下：

<?php
require 'vendor/autoload.php';

// 初始化 Sentry
Sentry\init(['dsn' => 'https://your_sentry_dsn_url@m66.net']);

$mysqli = new mysqli("localhost", "user", "password", "database");

if ($mysqli->connect_error) {
    echo "连接失败: " . $mysqli->connect_error;
    exit();
}

$query = "SELECT * FROM nonexistent_table";
$result = $mysqli->query($query);

if ($mysqli->errno) {
    // 捕获数据库错误，并将其上报到 Sentry
    Sentry\captureException(new Exception("SQL 错误代码: " . $mysqli->errno . " 错误信息: " . $mysqli->error));
    echo "发生了错误，已上报到监控平台。";
}
?>

在上面的代码中，当 mysqli 执行查询时，如果发生了错误，错误信息会通过 Sentry\captureException() 方法被上报到 Sentry 平台进行监控。

4. 使用其他监控平台

除了 Sentry，您也可以将错误信息发送到其他监控平台。以下是使用不同平台的基本集成方式：

a) 使用 Bugsnag

Bugsnag 是另一个流行的错误监控工具。您可以通过以下方式将错误发送到 Bugsnag：

require 'vendor/autoload.php';

// 初始化 Bugsnag
Bugsnag::start('your_bugsnag_api_key');

$mysqli = new mysqli("localhost", "user", "password", "database");

if ($mysqli->connect_error) {
    echo "连接失败: " . $mysqli->connect_error;
    exit();
}

$query = "SELECT * FROM nonexistent_table";
$result = $mysqli->query($query);

if ($mysqli->errno) {
    // 捕获数据库错误，并将其上报到 Bugsnag
    Bugsnag::notifyException(new Exception("SQL 错误代码: " . $mysqli->errno . " 错误信息: " . $mysqli->error));
    echo "发生了错误，已上报到 Bugsnag。";
}

b) 使用 LogRocket

LogRocket 是另一个支持前端和后端错误追踪的工具。如果您的 PHP 后端需要集成 LogRocket，您可以通过 API 上报错误信息：

require 'vendor/autoload.php';

// LogRocket 集成 (假设 LogRocket PHP SDK 已存在)
LogRocket::init('your_logrocket_project_id');

$mysqli = new mysqli("localhost", "user", "password", "database");

if ($mysqli->connect_error) {
    echo "连接失败: " . $mysqli->connect_error;
    exit();
}

$query = "SELECT * FROM nonexistent_table";
$result = $mysqli->query($query);

if ($mysqli->errno) {
    // 捕获数据库错误，并将其上报到 LogRocket
    LogRocket::captureError("SQL 错误代码: " . $mysqli->errno . " 错误信息: " . $mysqli->error);
    echo "发生了错误，已上报到 LogRocket。";
}

5. 完整示例：集成 Sentry 和错误捕捉

综合上述内容，您可以参考以下完整示例，使用 mysqli::$errno 捕捉数据库错误并上报到 Sentry：

<?php
require 'vendor/autoload.php';

// 初始化 Sentry
Sentry\init(['dsn' => 'https://your_sentry_dsn_url@m66.net']);

$mysqli = new mysqli("localhost", "user", "password", "database");

if ($mysqli->connect_error) {
    echo "连接失败: " . $mysqli->connect_error;
    exit();
}

$query = "SELECT * FROM nonexistent_table";
$result = $mysqli->query($query);

if ($mysqli->errno) {
    // 捕获数据库错误，并将其上报到 Sentry
    Sentry\captureException(new Exception("SQL 错误代码: " . $mysqli->errno . " 错误信息: " . $mysqli->error));
    echo "发生了错误，已上报到 Sentry。";
}
?>

6. 总结

通过使用 mysqli::$errno 属性，您可以轻松地捕捉数据库操作中的错误，并将其上报到 Sentry、Bugsnag 或 LogRocket 等监控平台。这样，您就可以及时发现潜在问题，增强系统的稳定性和可维护性。

在集成这些监控工具时，记得选择适合您项目的 SDK，并根据平台文档进行相应的配置。

mysqli::$errno