int
mysql_ping(MYSQL *mysql)

Проверяет, работает ли подключение к серверу. Если подключение прервано, а автоматическое переподключение включено, выполняется попытка переподключения. Если подключение прервано, а автоматическое переподключение отключено, mysql_ping() возвращает ошибку.

Автоматическое переподключение отключено по умолчанию. Чтобы включить его, вызовите mysql_options() с опцией MYSQL_OPT_RECONNECT (устарела начиная с MySQL 8.0.34). Подробности см. в разделе 5.4.54, «mysql_options()».

mysql_ping() можно использовать для клиентов, которые остаются бездействующими в течение длительного времени, чтобы проверить, закрыл ли сервер подключение, и переподключиться при необходимости.

Если mysql_ping()) приводит к переподключению, нет явного указания на это. Чтобы определить, произошло ли переподключение, вызовите mysql_thread_id() для получения исходного идентификатора подключения перед вызовом mysql_ping(), а затем снова вызовите mysql_thread_id(), чтобы увидеть, изменился ли идентификатор.

При переподключении некоторые характеристики подключения будут сброшены. Подробности о этих характеристиках см. в разделе 3.6.8, «Управление автоматическим переподключением».

Ноль, если подключение к серверу активно. Неноль, если произошла ошибка. Возврат ненулевого значения не указывает на то, что сам сервер MySQL не работает; подключение может быть прервано по другим причинам, таким как проблемы с сетью.