如何用mysqli::$info函数实现对SQL执行状态的实时监控？

gitbox 2025-09-30

在开发PHP应用程序时，监控SQL查询的执行状态对于调试和优化性能至关重要。mysqli扩展为我们提供了多种方法来与MySQL数据库进行交互，其中mysqli::$info函数便是一个用于获取关于最后执行的SQL查询的详细信息的强大工具。本文将介绍如何利用mysqli::$info函数实时监控SQL执行状态。

一、什么是mysqli::$info函数？

mysqli::$info是一个PHP mysqli类的属性，它提供了与数据库交互的详细信息，尤其是在执行查询之后。通过该属性，开发者可以获取SQL语句执行的状态，包括受影响的行数、警告信息等。

该属性主要用于以下几种场景：

获取SQL查询执行后的统计信息
查看SQL执行过程中是否有警告
获取受影响的行数（例如，在更新、删除操作后）

二、如何使用mysqli::$info函数？

mysqli::$info是一个只读属性，返回的是与执行最后一条SQL语句相关的消息。其基本的使用方式如下：

<span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-comment">// 创建数据库连接</span></span><span>
</span><span><span class="hljs-variable">$mysqli</span></span><span> = </span><span><span class="hljs-keyword">new</span></span><span> </span><span><span class="hljs-title function_ invoke__">mysqli</span></span><span>(</span><span><span class="hljs-string">"localhost"</span></span><span>, </span><span><span class="hljs-string">"username"</span></span><span>, </span><span><span class="hljs-string">"password"</span></span><span>, </span><span><span class="hljs-string">"database_name"</span></span><span>);

</span><span><span class="hljs-comment">// 检查连接是否成功</span></span><span>
</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$mysqli</span></span><span>-&gt;connect_error) {
    </span><span><span class="hljs-keyword">die</span></span><span>(</span><span><span class="hljs-string">"连接失败: "</span></span><span> . </span><span><span class="hljs-variable">$mysqli</span></span><span>-&gt;connect_error);
}

</span><span><span class="hljs-comment">// 执行SQL查询</span></span><span>
</span><span><span class="hljs-variable">$sql</span></span><span> = </span><span><span class="hljs-string">"UPDATE users SET status = 'active' WHERE last_login &gt; '2025-01-01'"</span></span><span>;
</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$mysqli</span></span><span>-&gt;</span><span><span class="hljs-title function_ invoke__">query</span></span><span>(</span><span><span class="hljs-variable">$sql</span></span><span>) === </span><span><span class="hljs-literal">TRUE</span></span><span>) {
    </span><span><span class="hljs-comment">// 输出SQL执行状态</span></span><span>
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"SQL执行成功: "</span></span><span> . </span><span><span class="hljs-variable">$mysqli</span></span><span>-&gt;info;
} </span><span><span class="hljs-keyword">else</span></span><span> {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"SQL执行失败: "</span></span><span> . </span><span><span class="hljs-variable">$mysqli</span></span><span>-&gt;error;
}

</span><span><span class="hljs-comment">// 关闭连接</span></span><span>
</span><span><span class="hljs-variable">$mysqli</span></span><span>-&gt;</span><span><span class="hljs-title function_ invoke__">close</span></span><span>();
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

在上面的例子中，当我们执行UPDATE语句后，可以通过$mysqli->info获取SQL执行的详细信息。如果SQL执行成功，它会返回一条关于受影响行数的信息。如果SQL执行失败，它则会输出错误信息。

三、mysqli::$info函数的常见返回值

mysqli::$info的返回值通常包含以下内容：

受影响的行数：例如，对于INSERT、UPDATE、DELETE等操作，mysqli::$info会返回影响的行数。
警告数量：如果在执行SQL时发生了警告，返回的内容可能会显示警告数量。
其他查询信息：对于特定的查询，mysqli::$info可能还会返回其他执行信息。

举个例子：

<span><span><span class="hljs-variable">$sql</span></span><span> = </span><span><span class="hljs-string">"UPDATE users SET status = 'active' WHERE last_login &gt; '2025-01-01'"</span></span><span>;
</span><span><span class="hljs-variable">$mysqli</span></span><span>-&gt;</span><span><span class="hljs-title function_ invoke__">query</span></span><span>(</span><span><span class="hljs-variable">$sql</span></span><span>);
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-variable">$mysqli</span></span><span>-&gt;info; </span><span><span class="hljs-comment">// 返回：Records updated: 50</span></span><span>
</span></span>

在这个例子中，mysqli::$info会返回一条信息，说明有50条记录被更新。

四、使用mysqli::$info进行实时监控

为了实现对SQL执行状态的实时监控，我们可以通过mysqli::$info不断地获取查询信息，并在每次执行SQL操作后进行检查。这种方式尤其适合用于开发阶段的调试或性能分析。

例如，我们可以在批量执行多个SQL查询时，通过记录每次查询后mysqli::$info的返回值来监控每个操作的效果：

<span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-variable">$queries</span></span><span> = [
    </span><span><span class="hljs-string">"INSERT INTO users (name, email) VALUES ('John Doe', '[email protected]')"</span></span><span>,
    </span><span><span class="hljs-string">"UPDATE users SET status = 'inactive' WHERE last_login &lt; '2024-01-01'"</span></span><span>,
    </span><span><span class="hljs-string">"DELETE FROM users WHERE id = 101"</span></span><span>
];

</span><span><span class="hljs-keyword">foreach</span></span><span> (</span><span><span class="hljs-variable">$queries</span></span><span> </span><span><span class="hljs-keyword">as</span></span><span> </span><span><span class="hljs-variable">$query</span></span><span>) {
    </span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$mysqli</span></span><span>-&gt;</span><span><span class="hljs-title function_ invoke__">query</span></span><span>(</span><span><span class="hljs-variable">$query</span></span><span>)) {
        </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"查询执行成功: "</span></span><span> . </span><span><span class="hljs-variable">$mysqli</span></span><span>-&gt;info . </span><span><span class="hljs-string">"&lt;br&gt;"</span></span><span>;
    } </span><span><span class="hljs-keyword">else</span></span><span> {
        </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"查询执行失败: "</span></span><span> . </span><span><span class="hljs-variable">$mysqli</span></span><span>-&gt;error . </span><span><span class="hljs-string">"&lt;br&gt;"</span></span><span>;
    }
}
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

在这个例子中，每当我们执行一个查询时，都会立即通过$mysqli->info来输出当前SQL语句的执行状态。这对于批量操作或者复杂的事务处理非常有帮助，可以帮助我们实时监控执行的效果。

五、注意事项

仅适用于最后一条SQL语句：mysqli::$info仅能提供关于最后执行SQL语句的反馈。如果你在同一个脚本中执行多个查询，它只会返回最后一个查询的执行信息。
数据库连接问题：如果数据库连接出现问题，mysqli::$info可能不会返回有效的信息，因此在使用时应确保数据库连接正常。
错误与警告：mysqli::$info主要用于获取执行的概况，如果你需要详细的错误信息，应该使用mysqli::$error属性。

六、总结

mysqli::$info是一个非常实用的属性，它可以帮助开发者实时监控SQL查询的执行状态。通过使用这个属性，可以在执行SQL操作后获得执行的详细信息，进而帮助开发者更好地调试和优化代码。特别是在复杂的数据库操作和批量查询中，mysqli::$info能够提供关键的反馈信息，帮助开发者做出相应的调整。

如果你正在构建一个需要频繁执行SQL操作的PHP应用，结合mysqli::$info进行实时监控将极大地提高你调试和优化的效率。

相关标签:
mysqli SQL