Documentation Home

5.4.56 mysql_ping()

int
mysql_ping(MYSQL *mysql)

描述

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

默认情况下禁用自动重新连接。要启用它,请 mysql_options()使用 MYSQL_OPT_RECONNECT选项调用。有关详细信息,请参阅第 5.4.54 节,“mysql_options()”

mysql_ping()可供长时间保持空闲的客户端使用,以检查服务器是否已关闭连接并在必要时重新连接。

如果mysql_ping()) 确实导致重新连接,则没有明确指示。判断是否重连, mysql_thread_id()在调用前先调用获取原来的连接标识 mysql_ping(),再调用 mysql_thread_id()看标识是否改变。

如果发生重新连接,连接的某些特性将被重置。有关这些特性的详细信息,请参阅第 3.6.8 节“自动重新连接控制”

返回值

如果与服务器的连接处于活动状态,则为零。如果发生错误,则非零。非零返回并不表示 MySQL 服务器本身是否已关闭;连接可能因其他原因(例如网络问题)而中断。

错误