27.7.6.52 mysql_ping()
int mysql_ping(MYSQL *mysql)
Description
检查与服务器的连接是否正常。如果连接断开并且启用了自动重新连接，则尝试重新连接。如果连接断开并且禁用了自动重新连接，则mysql_ping()返回错误。
默认情况下，自动重新连接处于禁用状态。要启用它，请使用MYSQL_OPT_RECONNECT选项调用mysql_options()。有关详细信息，请参见第 27.7.6.50 节“ mysql_options()”。
mysql_ping()可由长时间处于空闲状态的 Client 端使用，以检查服务器是否已关闭连接并在必要时重新连接。
如果mysql_ping())确实导致了重新连接，则没有明确的指示。要确定是否发生重新连接，请在调用mysql_ping()之前先调用mysql_thread_id()以获取原始连接标识符，然后再次调用mysql_thread_id()以查看标识符是否已更改。
如果发生重新连接，则连接的某些 Feature 将被重置。有关这些 Feature 的详细信息，请参见第 27.7.19 节“ C API 自动重新连接控制”。
Return Values
如果与服务器的连接处于活动状态，则为零。如果发生错误，则为非零值。非零返回值并不 table 示 MySQL 服务器本身是否已关闭。连接可能由于其他原因(例如网络问题)而中断。
Errors
命令执行 Sequences 不正确。
MySQL 服务器已经消失了。
出现未知错误。
