int
mysql_ping(MYSQL *mysql)
检查与服务器的连接是否有效。如果连接断开并且启用了自动重新连接,则会尝试重新连接。如果连接断开并且自动重新连接被禁用,则
mysql_ping()
返回错误。
默认情况下禁用自动重新连接。要启用它,请
mysql_options()
使用
MYSQL_OPT_RECONNECT
选项调用。有关详细信息,请参阅第 5.4.50 节,“mysql_options()”。
mysql_ping()
可供长时间保持空闲的客户端使用,以检查服务器是否已关闭连接并在必要时重新连接。
如果mysql_ping()
) 确实导致重新连接,则没有明确指示。判断是否重连,
mysql_thread_id()
在调用前先调用获取原来的连接标识
mysql_ping()
,再调用
mysql_thread_id()
看标识是否改变。
如果发生重新连接,连接的某些特性将被重置。有关这些特性的详细信息,请参阅第 3.6.6 节“自动重新连接控制”。
-
命令的执行顺序不正确。
-
MySQL 服务器已经消失。
-
出现未知错误。