[函数]imap_headerinfo()函数—用法及示例

函数名：imap_headerinfo()

函数描述：imap_headerinfo()函数返回一个关联数组，包含了指定邮件的头信息。

适用版本：该函数适用于PHP 4 >= 4.0.7, PHP 5, PHP 7

语法：array imap_headerinfo ( resource $imap_stream , int $msg_number [, int $fromlength = 0 [, bool $subjectlength = 0 [, string $default_host = NULL ]]] )

参数：

• $imap_stream：必需，一个有效的 IMAP 流资源，通过 imap_open() 函数返回。
• $msg_number：必需，要获取头信息的邮件的消息号码。
• $fromlength：可选，指定返回的发件人的最大长度，默认为 0。
• $subjectlength：可选，指定返回的主题的最大长度，默认为 0。
• $default_host：可选，指定默认的主机名，默认为 NULL。

返回值：返回一个关联数组，包含了指定邮件的头信息。如果出错，将返回 FALSE。

示例：

// 连接到 IMAP 服务器
$imap_stream = imap_open("{imap.example.com:993/imap/ssl}INBOX", "username", "password");

// 获取邮件头信息
$headerinfo = imap_headerinfo($imap_stream, 1);

// 打印发件人和主题
echo "发件人：" . $headerinfo->fromaddress . "\n";
echo "主题：" . $headerinfo->subject . "\n";

// 关闭 IMAP 连接
imap_close($imap_stream);

以上示例中，我们首先使用 imap_open() 函数连接到 IMAP 服务器。然后，使用 imap_headerinfo() 函数获取第一封邮件的头信息。最后，我们打印出发件人和主题。请注意，此示例仅适用于已经连接到 IMAP 服务器的情况。