imap_listscan
(PHP 4, PHP 5, PHP 7, PHP 8)
imap_listscan — Listet Postfächer nach Suchkriterien
Beschreibung
$imap_stream
, string $ref
, string $pattern
, string $content
) : array
Liefert ein Array mit den Namen der Postfächer in deren Inhalt
der Suchtext content vorkommt.
Diese Funktion verhält sich ähnlich wie imap_listmailbox()
sucht aber zusätzlich nach dem Suchtext content
innerhalb der Daten des Postfachs.
Parameter-Liste
-
imap -
Eine von imap_open() zurückgegebene IMAP-Verbindung.
-
ref -
Serverspezifikation wie in imap_open() beschrieben.
WarnungPassing untrusted data to this parameter is insecure, unless imap.enable_insecure_rsh is disabled.
-
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. -
content -
Der zu suchende Text
Rückgabewerte
Liefert ein Array mit den Namen der Postfächer in deren Inhalt
der Suchtext content vorkommt.
Siehe auch
- imap_listmailbox() - Alias von imap_list
- imap_search() - Liefert ein Array von Nachrichten, die den gegebenen Suchkriterien entsprechen
add a note
