开发调试工具：实时监控 mysqli::get_warnings 输出

gitbox 2025-05-26

什么是 mysqli::get_warnings？

mysqli::get_warnings 是 PHP 的 MySQLi 扩展提供的一个方法，用于获取最近执行的 SQL 语句产生的警告信息。它返回一个 mysqli_warning 对象链，每个对象包含一个警告的详细信息，如错误代码和警告消息。

通过遍历这些警告，开发者可以捕获到未被显式抛出但可能影响数据正确性的细节。

监控数据库警告的基本思路

执行 SQL 查询后，调用 get_warnings 检查是否有警告。
遍历警告链，将警告信息收集起来。
将警告信息实时输出或保存，方便后续分析。
可结合日志系统或前端展示，形成可视化监控工具。

示例代码

下面的示例演示了如何执行一条 SQL 语句，并通过 mysqli::get_warnings 获取警告信息，输出到调试日志中。

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

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

// 示例 SQL：插入重复主键可能会产生警告
$sql = "INSERT INTO test_table (id, name) VALUES (1, 'Alice')";

// 执行查询
if ($mysqli->query($sql) === TRUE) {
    echo "查询执行成功\n";

    // 获取警告
    if ($warnings = $mysqli->get_warnings()) {
        do {
            echo "警告代码: " . $warnings->errno . "\n";
            echo "警告信息: " . $warnings->message . "\n";
        } while ($warnings = $warnings->next());
    } else {
        echo "无警告\n";
    }
} else {
    echo "查询执行失败: " . $mysqli->error . "\n";
}

$mysqli->close();
?>

实时监控警告的扩展方案

1. 自动写入日志文件

为了持久保存警告信息，可以将警告写入文件：

function logWarnings($mysqli) {
    if ($warnings = $mysqli->get_warnings()) {
        $logFile = 'db_warnings.log';
        do {
            $log = date('Y-m-d H:i:s') . " - Warning {$warnings->errno}: {$warnings->message}\n";
            file_put_contents($logFile, $log, FILE_APPEND);
        } while ($warnings = $warnings->next());
    }
}

每次执行数据库操作后调用 logWarnings($mysqli) 即可实现自动记录。

2. 前端页面实时显示

通过 AJAX 调用 PHP 脚本，返回最新警告，前端页面可以实时更新警告列表，方便开发者查看。

注意事项

警告只与最近一次数据库操作相关，执行新语句后旧警告会被覆盖。
mysqli::get_warnings 仅在 MySQL 服务器支持警告机制时有效。
频繁查询和记录警告可能对性能有一定影响，建议只在调试环境或异常监控时启用。

总结

利用 PHP 的 mysqli::get_warnings 函数，可以有效获取数据库操作中的警告信息。结合日志记录和实时展示技术，能构建一个简单的数据库警告监控工具，帮助开发者及时发现潜在问题，优化数据库访问和应用性能。