imap_search

(PHP 3 >= 3.0.12, PHP 4, PHP 5)

imap_search -- Liefert ein Array von Nachrichten die den gegebenen Suchkriterien entsprechen

Beschreibung

array imap_search ( resource imap_stream, string criteria [, int options [, string charset]] )

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

VersionBeschreibung
4.3.3 Der Parameter charset wurde hinzugefügt

Siehe auch

imap_listscan()