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 выключен; подключение может быть прервано по другим причинам, таким как проблемы с сетью.