array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.imap-ping.php', 1 => 'imap_ping', 2 => 'Prüft einen IMAP-Stream auf Funktionalität', ), 'up' => array ( 0 => 'ref.imap.php', 1 => 'IMAP Funktionen', ), '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' => 'de', '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 — Prüft einen IMAP-Stream auf Funktionalität

Beschreibung

imap_ping(IMAP\Connection $imap): bool

imap_ping() 'pingt' einen IMAP-Stream an, um zu sehen, ob dieser noch aktiv ist. Diese Funktion kann auch neu eingetroffene Nachrichten erkennen. Daher ist dies die bevorzugte Methode zur regelmäßigen Überprüfung auf neue Nachrichten und um die Verbindung bei Servern offen zu halten, die sie sonst nach einer gewissen Zeit der Inaktivität beenden.

Parameter-Liste

imap

Eine IMAP\Connection-Instanz.

Rückgabewerte

Gibt true zurück, wenn der Stream noch funktioniert, sonst false.

Changelog

Version Beschreibung
8.1.0 Der Parameter imap erwartet nun eine IMAP\Connection-Instanz; vorher wurde eine gültige imap-Ressource erwartet.

Beispiele

Beispiel #1 imap_ping()-Beispiel

<?php

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

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

?>