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
}

?>

add a note

User Contributed Notes 1 note

down

-18

Anonymous ¶

21 years ago


This is a great solution for a webmail class if you want to make sure that a user is still logged in. Example:

<?php
if(!(imap_ping($stream)) {
die("The user is no longer logged in.");
?>

add a note