(PHP 4, PHP 5, PHP 7)
imap_listscan — Listet Postfächer nach Suchkriterien
$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.
imap_streamEine von imap_open() zurückgegebene IMAP-Verbindung.
refServerspezifikation wie in imap_open() beschrieben.
Passing untrusted data to this parameter is insecure, unless imap.enable_insecure_rsh is disabled.
patternGibt an, wo in der Mailbox-Hierarchie mit der Suche begonnen werden soll.
Es gibt zwei Sonderzeichen, die man als Teil des pattern verwenden kann:
'*' und '%'.
'*' heißt, dass alle Mailboxen zurückgegeben werden sollen. Wenn man pattern als '*' übergibt, so erhält man eine Liste der vollständigen Mailboxhierarchie.
'%' heißt, dass nur die aktuelle Stufe zurückgegeben wird.
'%' als Wert des pattern Parameters wird nur die Mailboxen auf höchster Stufe zurückgeben.
'~/mail/%' unter UW_IMAPD wird jede Mailbox innerhalb des
~/mail-Verzeichnisses zurückgeben, aber keine innerhalb von dessen Unterverzeichnissen.
contentDer zu suchende Text
Liefert ein Array mit den Namen der Postfächer in deren Inhalt
der Suchtext content vorkommt.