检查与服务器的连接是否正常。如果连接已断开并且启用了自动重新连接，则会尝试重新连接。如果连接已断开并且禁用了自动重新连接，则 mysql_ping() 将返回错误。

默认情况下，自动重新连接处于禁用状态。要启用它，请使用 MYSQL_OPT_RECONNECT 选项（已弃用）调用 mysql_options()。有关详细信息，请参见 第 5.4.54 节“mysql_options()”。

长时间处于空闲状态的客户端可以使用 mysql_ping() 来检查服务器是否已关闭连接，并在必要时重新连接。

如果 mysql_ping() 确实导致重新连接，则不会明确指示。要确定是否发生重新连接，请在调用 mysql_ping() 之前调用 mysql_thread_id() 以获取原始连接标识符，然后再次调用 mysql_thread_id() 以查看标识符是否已更改。

如果发生重新连接，则连接的某些特征将已重置。有关这些特征的详细信息，请参见 第 3.6.8 节“自动重新连接控制”。

如果与服务器的连接处于活动状态，则返回零。如果发生错误，则返回非零值。非零返回值并不表示 MySQL 服务器本身已关闭；连接可能由于其他原因（如网络问题）而断开。