imap_ping

(PHP 4, PHP 5)

imap_ping — Prüft einen IMAP-Stream auf Funktionalität

Beschreibung

bool imap_ping ( resource $imap_stream )

imap_ping() 'pingt' einen IMAP-Stream um zu sehen ob dieser noch aktiv und funktional ist. Sie kann neue Nachrichten entdecken, ein imap_ping() ist daher die bevorzugte Methode für periodische Prüfungen auf neue Nachrichten sowie als Keepalive Signal für Server die Verbindungen nach einer gewissen Zeit der Inaktivität beenden.

Parameter-Liste

imap_stream: Eine von imap_open() zurückgegebene IMAP-Verbindung.

Rückgabewerte

Liefert TRUE wenn der Stream noch funktioniert, sonst FALSE.

Beispiele

Beispiel #1 imap_ping() Example


<?php

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

// nach einer gewissen Zeit
if (!imap_ping($imap)) {
    // Verbindung wieder aufbauen
}

?>