imap_mail_copy()函式—用法及示例

函式名稱：imap_mail_copy() 適用版本：PHP 4, PHP 5, PHP 7

函式描述： imap_mail_copy() 函式用於將指定的郵件從一個郵箱複製到另一個郵箱。該函式使用 IMAP 擴充套件庫來實現。

語法： bool imap_mail_copy ( resource $imap_stream , string $msglist , string $mailbox [, int $options = 0 ] )

引數：

• $imap_stream：IMAP 郵箱連線資源，透過 imap_open() 函式獲得。
• $msglist：要複製的郵件的訊息號。可以是單個訊息號（例如"1"）或一系列訊息號（例如"2:4,6"）。
• $mailbox：目標郵箱的名稱，可以是相對路徑（相對於郵箱的當前位置）或絕對路徑。
• $options（可選）：可選的引數，用於指定複製操作的選項，例如 CP_UID（使用 UID 而不是訊息號）和 CP_MOVE（將郵件從原始郵箱中移動到目標郵箱）。

返回值： 如果複製成功，則返回 true。如果複製失敗，則返回 false。

示例：

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

// 將郵件 1 複製到目標郵箱 "Archive"
if (imap_mail_copy($imap_stream, "1", "Archive")) {
    echo "郵件複製成功！";
} else {
    echo "郵件複製失敗。";
}

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

注意事項：

• 在使用該函式之前，必須透過 imap_open() 函式連線到 IMAP 郵箱。
• 郵件的訊息號可以透過 imap_search() 函式或其他方式獲得。
• 目標郵箱的名稱可以是相對路徑（例如 "INBOX.Archive"）或絕對路徑（例如 "{imap.example.com:993/imap/ssl}INBOX.Archive"）。
• 可以使用 $options 引數來指定複製操作的選項，例如使用 UID 而不是訊息號，或將郵件從原始郵箱中移動到目標郵箱。