imap_header()函式—用法及示例

函式名：imap_header()

適用版本：PHP 4, PHP 5, PHP 7

函式描述：imap_header()函式用於獲取指定郵件的頭部資訊。

語法：mixed imap_header ( resource $imap_stream , int $msg_number [, int $from_length = 0 [, int $subject_length = 0 [, string $default_host = NULL ]]] )

引數：

• $imap_stream: IMAP連線資源，透過imap_open()函式返回。
• $msg_number: 郵件的訊息號碼。
• $from_length (可選): 可選引數，指定傳送者名字的最大長度，預設為0，表示不限制長度。
• $subject_length (可選): 可選引數，指定主題的最大長度，預設為0，表示不限制長度。
• $default_host (可選): 可選引數，指定預設的郵件伺服器主機名，預設為NULL。

返回值：

• 成功時，返回一個包含郵件頭部資訊的物件。
• 失敗時，返回FALSE。

示例：

// 建立IMAP連線
$imap_stream = imap_open("{imap.example.com:993/ssl}INBOX", "username", "password");

// 獲取郵件頭部資訊
$msg_number = 1;
$header = imap_header($imap_stream, $msg_number);

// 列印傳送者姓名和主題
echo "From: " . $header->fromaddress . "\n";
echo "Subject: " . $header->subject . "\n";

// 關閉IMAP連線
imap_close($imap_stream);

以上示例演示瞭如何使用imap_header()函式獲取指定郵件的傳送者姓名和主題。首先，我們使用imap_open()函式建立一個IMAP連線，然後透過指定的訊息號碼呼叫imap_header()函式來獲取郵件的頭部資訊。最後，我們可以透過訪問返回的物件的屬性來獲取傳送者姓名和主題。最後，我們使用imap_close()函式關閉IMAP連線。

請注意，此示例中的郵件伺服器主機名、使用者名稱和密碼是示例資料，需要根據實際情況進行替換。