PHP Handbuch
Zurück |  | Nach vorne

# imap_search

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

imap_search -- Sucht Nachrichten, die den übergebenen Suchkriterien entsprechen

## Beschreibung

array imap_search ( int imap_stream, string criteria, int flags)

Diese Funktion durchsucht die Nachrichten des aktuellen Postfachs und liefert ein Array mit den Nummern der Nachrichten, die mit den angegebenen Kriterien übereinstimmen. Der Parameter `criteria` enthält einen String, der sich aus den folgenden Suchbegriffen zusammensetzen kann

- ALL - liefert alle Nachrichten, die den restlichen Kriterien entsprechen

- ANSWERED - das \\ANSWERED Flag der Nachricht ist gesetzt

- BCC "string" - Das Bcc: Feld der Nachricht enthält "string"

- BEFORE "date" - Das Date: Feld der Nachricht enthält ein Datum, das vor dem in "date" angegebenen liegt

- BODY "string" - Im Inhalt der Nachricht ist "string" enthalten

- CC "string" - Das Cc: Feld der Nachricht enthält "string"

- DELETED - Die Nachricht ist zum Löschen vorgemerkt

- FLAGGED - Das \\FLAGGED (wichtig bzw. dringend) Flag der Nachricht ist gesetzt

- FROM "string" - Das From: Feld der Nachricht enthält "string"

- KEYWORD "string" - Das Feld Keyword: enthält "string"

- NEW - die Nachricht ist neu

- OLD - die Nachricht ist nicht neu

- ON "date" - Das Datum in Date: entspricht "date"

- RECENT - Das \\RECENT Flag ist gesetzt

- SEEN - Das \\SEEN Flag ist gesetzt, die Nachricht wurde bereits einmal abgerufen

- SINCE "date" - Das Datum "date" liegt vor dem im Date: Feld der Nachricht

- SUBJECT "string" - "string" ist Teil des Betreffs der Nachricht

- TEXT "string" - "string" ist Teil der Nachricht (Kopf oder Inhalt)

- TO "string" - Das To: Feld der Nachricht enthält "string"

- UNANSWERED - Die Nachricht wurde nicht beantwortet, das \\Answered Flag ist nicht gesetzt

- UNDELETED - Die Nachricht ist nicht zum Löschen vorgemerkt

- UNFLAGGED - Die Nachricht ist nicht als 'wichtig' markiert

- UNKEYWORD "string" - "string" ist nicht Schlüsselwort der Nachricht

- UNSEEN - Die Nachricht wurde bisher nicht gelesen

Argumente, die Leerzeichen enthalten, müssen dabei in Anführungszeichen eingebettet werden.

Um zum Beispiel alle unbeantworteten Nachrichten von Mama zu finden übergeben Sie als `criteria`: "UNANSWERED FROM Mama". Die Suche scheint nicht zwischen Groß- und Kleinschreibung zu unterscheiden. Die Liste der Suchbegriffe entstand nach Inspektion der UW c-client Sourcen und ist vermutlich nicht vollständig (siehe auch RFC 2060, Abschnitt 6.4.4).

Enthält der optionale Parameter `flags` den Wert SE_UID, so werden UIDs anstelle von laufenden Nachrichtennummern zurückgegeben.

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