imap_ping
(PHP 4, PHP 5, PHP 7, PHP 8)
imap_ping — Prüft einen IMAP-Stream auf Funktionalität
Beschreibung
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.
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 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
}
?>