如何使用 mysqli::debug 和 var_dump 联合定位问题

M66 2025-06-01

在开发 PHP 应用时，我们常常需要与 MySQL 数据库交互，有时我们会遇到一些难以定位的问题，例如 SQL 查询没有按预期工作、数据库连接失败、或者查询结果与预期不符。为了更高效地排查这些问题，PHP 提供了一些有用的工具，如 mysqli::debug 和 var_dump，它们可以帮助我们更快速地定位问题。本文将介绍如何结合使用这两个工具，帮助我们解决数据库问题。

1. 使用 mysqli::debug 来查看数据库交互细节

mysqli::debug 是 mysqli 扩展提供的一个调试方法，它可以显示 MySQL 数据库与 PHP 之间的交互日志。当数据库连接或者 SQL 查询发生错误时，通过启用 mysqli::debug，可以获得详细的调试信息，帮助我们更清楚地了解发生了什么。

示例：启用调试模式

<?php
// 创建 MySQLi 实例
$mysqli = new mysqli('localhost', 'username', 'password', 'database');

// 启用调试模式
$mysqli->debug('d:t,query=on');

// 执行查询
$result = $mysqli->query('SELECT * FROM users WHERE email = "example@m66.net"');

// 获取查询结果
while ($row = $result->fetch_assoc()) {
    var_dump($row);
}

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

在上面的代码中，调用了 $mysqli->debug('d:t,query=on') 来启用调试模式。这样，所有的数据库操作（包括连接、查询等）都会打印详细的调试信息。特别是在执行查询时，我们可以清晰地看到 SQL 查询的细节，帮助我们诊断问题。

2. 使用 var_dump 打印变量

var_dump 是 PHP 的一个内建函数，用于打印变量的详细信息。它可以显示变量的类型和内容，特别适用于调试数组、对象等复杂的数据结构。

在数据库查询时，使用 var_dump 可以帮助我们查看查询结果的结构，确保数据是否按预期返回。例如，我们可以查看数据库查询结果中的字段值，或者检查 mysqli 查询函数是否返回了错误信息。

示例：使用 var_dump 打印查询结果

<?php
// 创建 MySQLi 实例
$mysqli = new mysqli('localhost', 'username', 'password', 'database');

// 执行查询
$query = 'SELECT * FROM users WHERE email = "example@m66.net"';
$result = $mysqli->query($query);

// 检查查询是否成功
if ($result) {
    // 使用 var_dump 输出查询结果
    var_dump($result->fetch_all(MYSQLI_ASSOC));
} else {
    // 如果查询失败，输出错误信息
    var_dump($mysqli->error);
}

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

在这段代码中，我们首先执行了一个查询，并使用 var_dump($result->fetch_all(MYSQLI_ASSOC)) 来打印查询结果。这样，我们就可以直接看到数据库返回的所有数据。通过查看这些数据，我们能够确认数据库查询是否按照我们的预期返回结果。

3. 结合使用 mysqli::debug 和 var_dump 提高调试效率

通过结合使用 mysqli::debug 和 var_dump，我们能够更全面地调试数据库问题。例如，在执行查询时，首先启用调试模式查看 SQL 查询的执行情况，然后通过 var_dump 输出查询结果或错误信息，这样可以快速地定位问题所在。

示例：结合使用

<?php
// 创建 MySQLi 实例
$mysqli = new mysqli('localhost', 'username', 'password', 'database');

// 启用调试模式
$mysqli->debug('d:t,query=on');

// 执行查询
$query = 'SELECT * FROM users WHERE email = "example@m66.net"';
$result = $mysqli->query($query);

// 打印查询结果
if ($result) {
    var_dump($result->fetch_all(MYSQLI_ASSOC));
} else {
    // 打印查询错误
    var_dump($mysqli->error);
}

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

在这个例子中，我们首先启用了 mysqli::debug 调试模式来查看数据库的所有操作日志。接着执行了查询，并用 var_dump 打印了查询结果。如果查询失败，var_dump($mysqli->error) 会输出错误信息，帮助我们快速找出问题所在。