mysqli::ping

    mysqli_ping

    (PHP 5, PHP 7, PHP 8)

    mysqli::ping -- mysqli_ping — Проверяет работоспособность соединения или пытается переподключиться, если соединение разорвано

    Описание

    Объектно-ориентированный стиль

    publicmysqli::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()

    Объектно-ориентированный стиль

    <?php
    $mysqli     = new mysqli("localhost", "my_user", "my_password", "world");


    if ($mysqli->connect_errno) {
    printf("Не удалось подключиться: %s\n", $mysqli->connect_error);
    exit();
    }


    if ($mysqli->ping()) {
    printf ("Соединение в порядке!\n");
    } else {
    printf ("Ошибка: %s\n", $mysqli->error);
    }


    $mysqli->close();
    ?>

    Процедурный стиль

    <?php
    $link     = mysqli_connect("localhost", "my_user", "my_password", "world");


    if (mysqli_connect_errno()) {
    printf("Не удалось подключиться: %s\n", mysqli_connect_error());
    exit();
    }


    if (mysqli_ping($link)) {
    printf ("Соединение в порядке!\n");
    } else {
    printf ("Ошибка: %s\n", mysqli_error($link));
    }


    mysqli_close($link);
    ?>

    Результат выполнения приведённых примеров: 

    Our connection is ok!
    To Top