mailparse_msg_get_part_data()函式—用法及示例

函式名：mailparse_msg_get_part_data()

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

用法： mailparse_msg_get_part_data(resource $mimemail): array

該函式用於獲取郵件的指定部分的相關資料。它接受一個 Mime 解析資源（透過 mailparse_msg_parse_file() 或 mailparse_msg_create() 函式獲得）作為引數，並返回一個包含部分資料的關聯陣列。

引數：

• $mimemail：Mime 解析資源，透過 mailparse_msg_parse_file() 或 mailparse_msg_create() 函式獲得。

返回值： 一個關聯陣列，包含以下鍵值對：

• 'starting-pos'：部分在郵件中的起始位置（以位元組為單位）。
• 'starting-pos-body'：部分在郵件正文中的起始位置（以位元組為單位）。
• 'ending-pos'：部分在郵件中的結束位置（以位元組為單位）。
• 'ending-pos-body'：部分在郵件正文中的結束位置（以位元組為單位）。
• 'start-offset'：部分在郵件中的起始位置（以行為單位）。
• 'start-offset-body'：部分在郵件正文中的起始位置（以行為單位）。
• 'end-offset'：部分在郵件中的結束位置（以行為單位）。
• 'end-offset-body'：部分在郵件正文中的結束位置（以行為單位）。
• 'thoroughness'：部分解析的詳細程度。
• 'charset'：部分的字符集。

示例：

// 建立 Mime 解析資源
$mime = mailparse_msg_create();

// 解析郵件檔案
mailparse_msg_parse_file($mime, 'path/to/email.eml');

// 獲取郵件的第一個部分的資料
$partData = mailparse_msg_get_part_data($mime);

// 輸出部分的起始位置和結束位置
echo "部分在郵件中的起始位置：{$partData['starting-pos']}\n";
echo "部分在郵件中的結束位置：{$partData['ending-pos']}\n";

// 輸出部分在郵件正文中的起始位置和結束位置
echo "部分在郵件正文中的起始位置：{$partData['starting-pos-body']}\n";
echo "部分在郵件正文中的結束位置：{$partData['ending-pos-body']}\n";

// 輸出部分的字符集
echo "部分的字符集：{$partData['charset']}\n";

以上示例程式碼將解析一個指定路徑的郵件檔案，並獲取該郵件的第一個部分的相關資料，包括在郵件中的位置和在郵件正文中的位置，以及部分的字符集。你可以根據需要使用其他鍵值對獲取更多關於部分的資訊。