(PHP 4, PHP 5, PHP 7, PHP 8)
imap_listscan — Liefert eine Liste von Postfächern nach Suchkriterien
$imap
,$reference
,$pattern
,$content
Gibt ein Array mit den Namen der Postfächer zurück, 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
Eine IMAP\Connection-Instanz.
reference
Die Angabe des Servers in der in imap_open() beschriebenen Form.
Die Ü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 Postfach-Hierarchie mit der Suche begonnen werden soll.
Es gibt zwei Sonderzeichen, die man als Teil von
pattern
verwenden kann:
'*
' und '%
'.
'*
' heißt, dass alle Postfächer zurückgegeben
werden sollen. Wenn man pattern
als
'*
' übergibt, so erhält man eine Liste der
vollständigen Postfach-Hierarchie.
'%
'
heißt, dass nur die aktuelle Stufe zurückgegeben wird.
'%
' als Wert des
pattern
Parameters wird nur die Postfächer
auf höchster Stufe zurückgeben. '~/mail/%
'
unter UW_IMAPD
wird jedes Postfach innerhalb des
Verzeichnisses ~/mail zurückgeben, aber keine innerhalb
von dessen Unterverzeichnissen.
content
Der zu suchende Text
Gibt ein Array mit den Namen der Postfächer zurück, in deren Inhalt der
Suchtext content
vorkommt. Bei einem Fehler wird false
zurückgegeben.
Version | Beschreibung |
---|---|
8.1.0 |
Der Parameter imap erwartet nun eine
IMAP\Connection-Instanz; vorher wurde eine Ressource
erwartet.
|