imap_ping

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

imap_pingCheck if the IMAP stream is still active

Descrição

imap_ping(IMAP\Connection$imap): bool

imap_ping() pings the stream to see if it's still active. It may discover new mail; this is the preferred method for a periodic "new mail check" as well as a "keep alive" for servers which have inactivity timeout.

Parâmetros

imap

Uma instância de IMAP\Connection.

Valor Retornado

Returns true if the stream is still alive, false otherwise.

Registro de Alterações

VersãoDescrição
8.1.0 O parâmetro imap agora espera uma instância de IMAP\Connection; anteriormente, um resourceimap válido era esperado.

Exemplos

Exemplo #1 imap_ping() Example

<?php

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

// after some sleeping
if (!imap_ping($imap)) {
// do some stuff to reconnect
}

?>
To Top