mysqli::get_warnings()函数—用法及示例

函数名：mysqli::get_warnings()

适用版本：PHP 5.3.0 及以上版本

函数说明：mysqli::get_warnings() 方法用于获取与最近一条执行的语句相关的警告或者错误信息。该方法只能在 mysqli 对象连接的最后一次查询之后调用，以获取警告信息。

语法：mysqli::get_warnings()

返回值：返回一个 mysqli_warning 对象的实例，表示查询中的警告信息。

示例代码：

// 创建mysqli对象并连接到数据库
$mysqli = new mysqli("localhost", "username", "password", "database");

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

// 获取警告信息
$warnings = $mysqli->get_warnings();

// 遍历并打印警告信息
while ($warning = $warnings->fetch_object()) {
    echo "警告：".$warning->message."\n";
    echo "错误码：".$warning->errno."\n";
    echo "SQL状态：".$warning->sqlstate."\n";
}

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

注意事项：

1. 在调用 mysqli::get_warnings() 方法之前，必须先执行一条查询语句，否则将无法获取到警告信息。
2. 如果查询没有产生任何警告信息，那么调用 mysqli::get_warnings() 方法将返回 NULL。
3. 警告信息可以包含有关查询执行的警告或者错误的详细信息，如警告消息、错误码和 SQL 状态等。
4. 警告信息是针对最近一次执行的语句而言的，如果有多个查询语句，只能获取到最后一个查询的警告信息。
5. 在使用 mysqli::get_warnings() 方法之后，务必调用 mysqli_warning::free() 方法释放内存，以避免内存泄漏。