• PHP-Handbuch
  • Funktionsreferenz
  • E-Mail-relevante Erweiterungen
  • IMAP
  • IMAP Funktionen
  • imap_8bit
  • imap_alerts
  • imap_append
  • imap_base64
  • imap_binary
  • imap_body
  • imap_bodystruct
  • imap_check
  • imap_clearflag_full
  • imap_close
  • imap_create
  • imap_createmailbox
  • imap_delete
  • imap_deletemailbox
  • imap_errors
  • imap_expunge
  • imap_fetch_overview
  • imap_fetchbody
  • imap_fetchheader
  • imap_fetchmime
  • imap_fetchstructure
  • imap_fetchtext
  • imap_gc
  • imap_get_quota
  • imap_get_quotaroot
  • imap_getacl
  • imap_getmailboxes
  • imap_getsubscribed
  • imap_header
  • imap_headerinfo
  • imap_headers
  • imap_last_error
  • imap_list
  • imap_listmailbox
  • imap_listscan
  • imap_listsubscribed
  • imap_lsub
  • imap_mail_compose
  • imap_mail_copy
  • imap_mail_move
  • imap_mail
  • imap_mailboxmsginfo
  • imap_mime_header_decode
  • imap_msgno
  • imap_num_msg
  • imap_num_recent
  • imap_open
  • imap_ping
  • imap_qprint
  • imap_rename
  • imap_renamemailbox
  • imap_reopen
  • imap_rfc822_parse_adrlist
  • imap_rfc822_parse_headers
  • imap_rfc822_write_address
  • imap_savebody
  • imap_scan
  • imap_scanmailbox
  • imap_search
  • imap_set_quota
  • imap_setacl
  • imap_setflag_full
  • imap_sort
  • imap_status
  • imap_subscribe
  • imap_thread
  • imap_timeout
  • imap_uid
  • imap_undelete
  • imap_unsubscribe
  • imap_utf7_decode
  • imap_utf7_encode
  • imap_utf8
imap_scanmailbox
imap_set_quota
IMAP Funktionen
PHP-Handbuch

imap_search

Liefert ein Array von Nachrichten die den gegebenen Suchkriterien entsprechen

Beschreibung

array imap_search ( resource $imap_stream , string $criteria [, int $options = SE_FREE [, string $charset = NIL ]] )

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 unterscheidet 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

Eine von imap_open zurückgegebene IMAP-Verbindung.

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