imap_lsub
(PHP 4, PHP 5, PHP 7, PHP 8)
imap_lsub — Liefert eine Liste aller abonnierten Postfächer
Beschreibung
$imap
, string $reference
, string $pattern
) : array|falseGibt ein Array aller vom Benutzer abonnierten Postfächer zurück.
Parameter-Liste
-
imap -
Eine von imap_open() zurückgegebene IMAP-Verbindung.
-
reference -
Die Angabe des Servers in der in imap_open() beschriebenen Form.
WarnungDie Übergabe von nicht vertrauenswürdigen Daten an diesen Parameter ist unsicher, falls imap.enable_insecure_rsh nicht deaktiviert ist.
-
pattern -
Gibt an, wo in der Mailbox-Hierarchie mit der Suche begonnen werden soll.
Es gibt zwei Sonderzeichen, die man als Teil des
patternverwenden kann: '*' und '%'. '*' heißt, dass alle Mailboxen zurückgegeben werden sollen. Wenn manpatternals '*' übergibt, so erhält man eine Liste der vollständigen Mailboxhierarchie. '%' heißt, dass nur die aktuelle Stufe zurückgegeben wird. '%' als Wert despatternParameters wird nur die Mailboxen auf höchster Stufe zurückgeben. '~/mail/%' unterUW_IMAPDwird jede Mailbox innerhalb des ~/mail-Verzeichnisses zurückgeben, aber keine innerhalb von dessen Unterverzeichnissen.
Rückgabewerte
Gibt ein Array mit allen abonierten Postfächern zurück.
Im Fehlerfall wird false zurückgegeben.
Siehe auch
- imap_list() - Liefert die Liste der Postfächer
- imap_getmailboxes() - Liefert detaillierte Informationen zu allen Postfächern
add a note
