imap_search
(PHP 4, PHP 5)
imap_search — Liefert ein Array von Nachrichten die den gegebenen Suchkriterien entsprechen
Beschreibung
imap_search() durchsucht die Nachrichten des aktuellen Postfachs.
Der Suchstring um zB nach allen unbeantworteten Nachrichten von Mutter zu suchen wäre "UNANSWERED FROM Mutter". Die Suche untercheidet nicht nach Groß- und Kleinschreibung. Die folgende Liste von Suchkriterien wurde aus dem Sourcecode des UW c-client erstellt, sie ist daher nicht unbedingt vollständig oder in allen Einzelheiten korrekt (siehe auch » RFC2060, Abschnitt 6.4.4).
Parameter Liste
- imap_stream
-
An IMAP stream returned by imap_open().
- criteria
-
Ein aus mit Leerzeichen getrennten Schlüsselworten und Argumenten. Argumente die selbt Leerzeichen enthalten müssen in doppelte Anführungszeichen gefasst werden (z.B. FROM "Hans Müller"). Es existieren folgende Schlüsselworte:
- ALL - return all messages matching the rest of the criteria
- ANSWERED - die gesuchten Nachrichten wurden beantwortet
- BCC "text" - die gesuchten Nachrichten enthalten "text" im Bcc: Feld
- BEFORE "datum" - die gesuchten Nachrichten wurden vor "datum" gesendet
- BODY "text" - der Nachrichtenkörper enthält "text"
- CC "text" - die gesuchten Nachrichten enthalten "text" im Cc: Feld
- DELETED - die gesuchten Nachrichten sind zur Löschung vorgemerkt
- FLAGGED - match messages with the \\FLAGGED (sometimes referred to as Important or Urgent) flag set
- FROM "text" - sucht Nachrichten mit "text" im Absender (From:)
- KEYWORD "text" - sucht Nachrichten mit Schlüsselwort "text"
- NEW - die gesuchten Nachrichten sind neu
- OLD - die gesuchten Nachrichten sind nicht neu
- ON "datum" - die Nachrichten wurden am angegebenen "datum" gesendet
- RECENT - sucht Nachrichten deren \\RECENT Flag nocht gesetzt ist
- SEEN - sucht bereits gelesene Nachrichten (das \\SEEN Flag ist gesetzt)
- SINCE "datum" - sucht nach "datum" gesendete Nachrichten
- SUBJECT "text" - sucht Nachrichten mit "text" in der Betreffzeile
- TEXT "text" - sucht Nachrichten deren Text "text" enthält
- TO "text" - sucht Nachrichten mit "text" im Empfänger (To:)
- UNANSWERED - sucht noch nicht beantwortete Nachrichten
- UNDELETED - sucht nicht zum Löschen vorgemerkte Nachrichten
- UNFLAGGED - sucht Nachrichten die nicht als wichtig markiert sind
- UNKEYWORD "text" - sucht Nachrichten in deren Schlüsselwörtern "text" nicht enthalten ist
- UNSEEN - sucht ungelesene Nachrichten
- options
-
Der Parameter options kann auf SE_UID gesetzt werden um UIDs statt Nachrichtennummern zurückzuerhalten.
- charset
-
Rückgabewerte
Liefert ein Array mit Nachrichtennummern oder UIDs.
Wenn die Suchkriterien keinen Sinn ergaben oder keine Nachrichten gefunden wurden wird FALSE zurückgegeben.
ChangeLog
Version | Beschreibung |
---|---|
4.3.3 | Der Parameter charset wurde hinzugefügt |