(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.
imapEine IMAP\Connection-Instanz.
referenceDie 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.
patternGibt 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 Parameters pattern gibt nur die Postfächer der obersten Ebene zurück.
'~/mail/%' unter UW_IMAPD gibt alle Postfächer des
Verzeichnisses ~/mail zurück, aber keine aus dessen Unterverzeichnissen.
contentDer 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 gültige
imap-Ressource erwartet.
|