# 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
}
?>`
`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open