PHP Manual: Fetch MIME headers for a particular section of the message

stringfalse imap_fetchmime(
    IMAP\Connection $imap,
    int $message_num,
    string $section,
    int $flags = 0
)

Fetch the MIME headers of a particular section of the body of the specified messages.

imap

An IMAP\Connection instance.

message_num

The message number

section

The part number. It is a string of integers delimited by period which index into a body part list as per the IMAP4 specification

flags

A bitmask with one or more of the following:

FT_UID - The message_num is a UID
FT_PEEK - Do not set the \Seen flag if not already set
FT_INTERNAL - The return string is in internal format, will not canonicalize to CRLF.

Returns the MIME headers of a particular section of the body of the specified messages as a text string, or false on failure.

Version	Description
8.1.0	The `imap` parameter expects an IMAP\Connection instance now; previously, a valid `imap` resource was expected.

imap_fetchmime