array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.imap-ping.php', 1 => 'imap_ping', 2 => 'Проверяет, активен ли ещё поток IMAP', ), 'up' => array ( 0 => 'ref.imap.php', 1 => 'Функции IMAP', ), 'prev' => array ( 0 => 'function.imap-open.php', 1 => 'imap_open', ), 'next' => array ( 0 => 'function.imap-qprint.php', 1 => 'imap_qprint', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/imap/functions/imap-ping.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

imap_ping

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

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

Описание

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)) {
// производим переподключение
}

?>