imap_bodystruct()函式—用法及示例

函式名：imap_bodystruct()

適用版本：PHP 4.3.0 及以上版本

用法：imap_bodystruct(resource $imap_stream, int $msg_number, string $section)

引數：

• $imap_stream：一個有效的 IMAP 流資源，透過 imap_open() 函式返回
• $msg_number：訊息的編號
• $section：訊息的特定部分，可以是整數或字串，用於指定訊息的特定部分，比如 1、2、1.2 等

返回值：返回一個物件，包含了訊息正文部分的結構資訊

示例：

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

// 獲取訊息編號為 1 的訊息的結構資訊
$msg_number = 1;
$section = '1.2';
$bodystruct = imap_bodystruct($imap_stream, $msg_number, $section);

// 列印結構資訊
echo "Type: " . $bodystruct->type . "\n";
echo "Encoding: " . $bodystruct->encoding . "\n";
echo "Subtype: " . $bodystruct->subtype . "\n";
echo "Parameters: " . print_r($bodystruct->parameters, true) . "\n";
echo "ID: " . $bodystruct->id . "\n";
echo "Description: " . $bodystruct->description . "\n";
echo "Size: " . $bodystruct->size . "\n";
echo "Lines: " . $bodystruct->lines . "\n";
echo "Disposition: " . $bodystruct->disposition . "\n";
echo "Language: " . $bodystruct->language . "\n";

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

說明：

• imap_bodystruct() 函式用於獲取指定訊息的正文部分的結構資訊。
• 引數 $imap_stream 是透過 imap_open() 函式返回的有效 IMAP 流資源。
• 引數 $msg_number 是要獲取結構資訊的訊息的編號。
• 引數 $section 是一個字串，用於指定訊息的特定部分。可以是整數或字串，比如 1、2、1.2 等。
• 返回值是一個物件，包含了訊息正文部分的結構資訊。
• 在示例中，首先透過 imap_open() 函式連線到 IMAP 伺服器。然後使用 imap_bodystruct() 函式獲取訊息編號為 1 的訊息的結構資訊，並將結果賦值給 $bodystruct 變數。最後，透過訪問 $bodystruct 物件的屬性，列印出結構資訊。最後使用 imap_close() 函式關閉 IMAP 連線。