PHP Handbuch
Zurück |  | Weiter

# 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

Version | Beschreibung
--- | ---
4.3.3 | Der Parameter `charset` wurde hinzugefügt

## Siehe auch

imap_listscan()

Zurück | Zum Anfang | Weiter
imap_scanmailbox | Nach oben | imap_set_quota