异常教程

PHP mysqli_info() 函数（千字长文）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

截止目前， 星球 内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习 ，欢迎点击围观

在 PHP 数据库操作中，mysqli_info() 函数是一个容易被忽视但功能强大的工具。它能够返回 MySQL 服务器执行最近查询后的状态信息，例如插入操作生成的自增 ID、影响的行数，或是某些特定查询的执行细节。对于编程初学者和中级开发者而言，理解并掌握这个函数，不仅能提升代码的健壮性，还能帮助开发者更高效地调试和优化数据库交互逻辑。本文将从基础概念、使用场景、代码示例到进阶技巧，全面解析 PHP mysqli_info() 函数 的核心知识，并通过生动的比喻和实际案例，帮助读者快速上手这一实用工具。

一、什么是 mysqli_info() 函数？

mysqli_info() 是 PHP 中用于获取 MySQL 数据库操作状态信息的函数。它通过分析最近一次通过 mysqli_query() 或其他数据库操作函数执行的 SQL 语句，返回服务器反馈的详细执行结果。

功能比喻：
可以将 mysqli_info() 想象成一位“数据库操作记录员”。每当开发者执行一条 SQL 语句（如插入、更新或查询），这位记录员会立即记录下操作的结果，例如“成功插入了 1 行数据，自增 ID 为 100”或“更新了 3 行记录”。开发者可以通过调用 mysqli_info()，随时查看这位“记录员”的笔记，从而快速了解操作的执行情况。

二、函数语法与参数说明

函数语法

string mysqli_info(mysqli $link)
  • 参数：$link 是通过 mysqli_connect() 建立的数据库连接对象。
  • 返回值：函数返回一个包含执行信息的字符串，若未执行任何操作或发生错误，则返回空字符串。

关键点解析

  1. 无需传递 SQL 语句：函数直接关联到最近一次通过同一连接执行的查询。
  2. 动态更新：每次执行新查询后，mysqli_info() 的返回值会自动更新为最新结果。
  3. 轻量高效：由于直接读取连接对象的状态，调用成本极低，适合频繁调试场景。

三、函数的核心应用场景

mysqli_info() 的核心价值在于为开发者提供以下三类关键信息：

1. 插入操作的自增 ID

当执行 INSERT 语句时，若表包含自增主键字段，mysqli_info() 会返回类似以下信息：

Records: 1 Duplicates: 0 Warnings: 0  
INSERT INTO table (id) VALUES (0)  
INSERT_ID=100

其中，INSERT_ID 后的数值即为新插入记录的自增 ID。

代码示例：

// 建立数据库连接  
$link = mysqli_connect("localhost", "user", "password", "database");  

// 执行插入操作  
mysqli_query($link, "INSERT INTO users (name) VALUES ('Alice')");  

// 获取插入后的自增 ID  
$info = mysqli_info($link);  
preg_match("/INSERT_ID=(\d+)/", $info, $matches);  
$last_id = $matches[1] ?? 0;  

echo "新插入的用户 ID 为：" . $last_id; // 输出：新插入的用户 ID 为：100

2. 更新与删除操作的影响行数

对于 UPDATE 或 DELETE 语句，mysqli_info() 返回的信息会包含影响的行数：

Records: 1 Duplicates: 0 Warnings: 0  
Rows matched: 1 Changed: 1 Warnings: 0

通过解析该字符串，开发者可以快速判断操作是否生效。

3. 其他执行细节

例如，执行 SELECT 语句时，可能返回关于查询执行计划的信息（需结合 EXPLAIN 关键字使用）；执行 LOAD DATA 导入操作时，会返回导入的记录数等。

四、与 mysqli_affected_rows() 的对比

mysqli_affected_rows() 是另一个常用的数据库操作状态函数，但两者功能有显著差异：

函数名返回值类型主要用途
mysqli_info()字符串获取 MySQL 服务器的原始执行信息
mysqli_affected_rows()整数获取最近操作影响的行数

使用场景选择：

  • 若需要精确的数字统计（如影响的行数），优先使用 mysqli_affected_rows()。
  • 若需要获取 MySQL 服务器返回的详细文本信息（如自增 ID、警告信息），则使用 mysqli_info()。

代码示例对比：

// 执行更新操作  
mysqli_query($link, "UPDATE users SET age = 25 WHERE id = 100");  

// 获取受影响的行数  
$affected_rows = mysqli_affected_rows($link);  
echo "受影响的行数：" . $affected_rows; // 输出：1  

// 获取详细执行信息  
$info = mysqli_info($link);  
echo "详细信息：" . $info; // 输出包含匹配行、修改行等文本信息

五、实战案例：组合使用 mysqli_info() 与错误处理

在实际开发中，建议将 mysqli_info() 与错误处理机制结合，构建更健壮的数据库交互逻辑。

案例 1：插入操作的完整流程

// 连接数据库  
$link = mysqli_connect("localhost", "user", "password", "database");  

// 开启事务（可选）  
mysqli_begin_transaction($link);  

// 执行插入操作  
$insert_query = "INSERT INTO users (name, email) VALUES ('Bob', 'bob@example.com')";  
if (mysqli_query($link, $insert_query)) {  
    // 成功时获取自增 ID  
    $info = mysqli_info($link);  
    preg_match("/INSERT_ID=(\d+)/", $info, $matches);  
    $last_id = $matches[1] ?? 0;  

    echo "成功插入，用户 ID：" . $last_id;  

    // 提交事务  
    mysqli_commit($link);  
} else {  
    // 错误时回滚事务  
    mysqli_rollback($link);  
    echo "插入失败：" . mysqli_error($link);  
}

案例 2：处理批量更新操作

// 执行批量更新  
$update_query = "UPDATE products SET price = price * 0.9 WHERE category = 'electronics'";  
if (mysqli_query($link, $update_query)) {  
    $affected = mysqli_affected_rows($link);  
    $info = mysqli_info($link);  

    echo "成功更新 $affected 条记录。\n";  
    echo "详细信息：" . $info; // 可能显示 "Rows matched: 20 Changed: 20 Warnings: 0"  
} else {  
    echo "更新失败：" . mysqli_error($link);  
}

六、进阶技巧与注意事项

1. 正则表达式解析信息字符串

由于 mysqli_info() 返回的是一段文本信息，开发者需要通过正则表达式提取关键数据。例如：

// 提取自增 ID  
if (preg_match("/INSERT_ID=(\d+)/", $info, $matches)) {  
    $id = (int)$matches[1];  
} else {  
    $id = 0;  
}

2. 注意连接对象的上下文

mysqli_info() 与数据库连接对象绑定，若在同一个连接中频繁切换查询，需确保调用 mysqli_info() 时指向的是最近一次操作。

3. 避免在 SELECT 后误用

执行 SELECT 查询后，mysqli_info() 可能返回空字符串或与查询无关的信息。此时建议改用 mysqli_num_rows() 获取行数。

4. 结合 MySQL 版本差异

不同版本的 MySQL 可能返回不同的信息格式，建议在代码中添加容错逻辑，例如：

$info = mysqli_info($link);  
if (empty($info)) {  
    // 处理无返回值的情况  
}

七、常见问题解答

Q1：为什么我的代码中 mysqli_info() 返回空字符串？

  • 确保函数调用紧跟在 mysqli_query() 之后，且未执行其他查询覆盖上下文。
  • 如果执行的是 SELECT 查询，可能返回空值，改用 mysqli_num_rows() 更合适。

Q2：如何在面向对象风格的代码中使用 mysqli_info()？

// 面向对象写法  
$link = new mysqli("localhost", "user", "password", "database");  
$link->query("INSERT INTO users (name) VALUES ('Charlie')");  
$info = $link->info;

Q3：mysqli_info() 是否支持事务？
是的，它会记录事务中的每一步操作信息，但需注意在事务提交前调用。

八、总结与展望

PHP mysqli_info() 函数如同数据库操作的“状态显示器”，为开发者提供了直接访问 MySQL 执行细节的窗口。通过掌握其语法、应用场景及解析技巧，开发者能够更高效地调试代码、优化数据库交互逻辑，并减少因信息不透明导致的错误。

在实际开发中，建议将 mysqli_info() 与 mysqli_affected_rows()、mysqli_error() 等函数结合使用，构建完整的数据库操作反馈机制。随着 MySQL 版本的迭代，该函数的功能可能进一步扩展，开发者应持续关注官方文档的更新，以充分利用其潜力。

希望本文能帮助读者快速上手 PHP mysqli_info() 函数，并在实际项目中发挥其价值！

最新发布

查看更多文章