Проверяет, активен ли ещё поток IMAP

# imap_ping

(PHP 4, PHP 5, PHP 7, PHP 8)

imap_ping — Проверяет, активен ли ещё поток IMAP

### Описание

function imap_ping(IMAP\Connection `$imap`): bool

Функция imap_ping() проверяет, активен ли ещё открытый поток. Это помогает узнавать, есть ли новая почта. Это приоритетный способ проверки появления новых сообщений и аналог постоянных соединений (keep alive) для серверов с настроенным временем ожидания неактивности.

### Список параметров

`imap`
  Экземпляр класса IMAP\Connection.

### Возвращаемые значения

Возвращает `true`, если поток активен и `false`, если нет.

### Список изменений

Версия | Описание
--- | ---
8.1.0 | Параметр `imap` теперь принимает объект IMAP\Connection; раньше параметр ждал ресурс (resource) `imap`.

### Примеры

Пример #1 Пример использования imap_ping()

    <?php

    $imap = imap_open("{imap.example.org}", "mailadmin", "password");

    // после некоторого ожидания
    if (!imap_ping($imap)) {
        // производим переподключение
    }

    ?>

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open