imap_fetchbody

(PHP 4, PHP 5, PHP 7, PHP 8)

imap_fetchbody — Liefert einen bestimmten Abschnitt aus dem Textkörper einer Nachricht

Beschreibung

imap_fetchbody(
    IMAP\Connection $imap,
    int $message_num,
    string $section,
    int $flags = 0
): string|false

Gibt den mit section angebenen Teil aus dem Textkörper der Nachricht message_num im aktuellen Postfach zurück. Der Teil des Textkörpers wird dabei nicht dekodiert.

Parameter-Liste

imap

Eine IMAP\Connection-Instanz.

message_num

Die Nummer der Nachricht

section

Die Nummer des gewünschten Nachrichtenteils. Diese wird gemäß der IMAP4-Spezifikation als String von mit Punkten getrennten Zahlen angegeben.

flags

Eine Bitmaske, die sich aus folgenden Werten zusammensetzen kann:

  • FT_UID - message_num ist eine UID
  • FT_PEEK - Das \Seen-Flag nicht setzen, falls es nicht bereits gesetzt ist
  • FT_INTERNAL - Rückgabe im internen Format ohne Umwandlung der Zeilenenden in CRLF.

Rückgabewerte

Gibt einen bestimmten Teil des Textkörpers der angegebenen Nachricht als Textstring zurück. Bei einem Fehler wird false zurückgegeben.

Changelog

Version Beschreibung
8.1.0 Der Parameter imap erwartet nun eine IMAP\Connection-Instanz; vorher wurde eine gültige imap-Ressource erwartet.

Siehe auch