imap_fetchheader
(PHP 4, PHP 5, PHP 7, PHP 8)
imap_fetchheader — Returns header for a message
Description
This function causes a fetch of the complete, unfiltered » RFC2822 format header of the specified message.
Parameters
-
imap
-
An IMAP\Connection instance.
-
message_num
-
The message number
-
flags
-
The possible
flags
are:-
FT_UID
- Themessage_num
argument is a UID -
FT_INTERNAL
- The return string is in "internal" format, without any attempt to canonicalize to CRLF newlines -
FT_PREFETCHTEXT
- The RFC822.TEXT should be pre-fetched at the same time. This avoids an extra RTT on an IMAP connection if a full message text is desired (e.g. in a "save to local file" operation)
-
Return Values
Returns the header of the specified message as a text string, or false
on failure.
Changelog
Version | Description |
---|---|
8.1.0 |
The imap parameter expects an IMAP\Connection
instance now; previously, a resource was expected.
|
See Also
- imap_fetch_overview() - Read an overview of the information in the headers of the given message