mysqli::ping
mysqli_ping
(PHP 5, PHP 7, PHP 8)
mysqli::ping -- mysqli_ping — Перевіряє працездатність з'єднання або намагається перепідключитися, якщо з'єднання розірвано
Опис
Об'єктно-орієнтований стиль
public mysqli::ping(): bool
Процедурний стиль
mysqli_ping(mysqli $mysql): bool
Перевіряє працездатність з'єднання із сервером. Якщо з'єднання розірвано, а глобальне налаштування mysqli.reconnect увімкнена, PHP спробує автоматично перепідключитися.
Зауваження: Налаштування php.ini mysqli.reconnect ігнорується драйвером "mysqlnd", тому автоматичного перепідключення не відбудеться.
Ця функція може використовуватися клієнтами, які простоюють без діла довгий час, щоб перевірити, чи сервер їх не відключив, і перепідключитися у разі потреби.
Список параметрів
mysql
Тільки для процедурного стилю: об'єкт mysqli, який повернула функція mysqli_connect()или функцияmysqli_init()
Значення, що повертаються
Повертає true у разі успішного виконання або **false**в случае возникновения ошибки.
Помилки
Якщо сповіщення про помилки mysqli включено (MYSQLI_REPORT_ERROR) та запитана операція не вдалася, видається попередження. Якщо, крім того, встановлено режим MYSQLI_REPORT_STRICT, натомість буде викинуто виняток mysqli_sql_exception
Приклади
Приклад #1 Приклад використання mysqli::ping()****
Об'єктно-орієнтований стиль
Процедурний стиль
Результат виконання наведених прикладів:
Our connection is ok!