imap_createmailbox()函式—用法及示例

函式名：imap_createmailbox()

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

用法：imap_createmailbox() 函式用於在指定的郵箱（郵件伺服器）上建立一個新的郵箱（資料夾）。

語法：bool imap_createmailbox ( resource $imap_stream , string $mailbox )

引數：

• imap_stream：必需，一個有效的 IMAP 流資源，使用 imap_open() 函式開啟。
• mailbox：必需，要建立的郵箱的名稱，可以是相對路徑或絕對路徑。

返回值：成功時返回 true，失敗時返回 false。

示例：

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

if ($imap_stream) {
    // 建立一個新的郵箱
    $mailbox = "INBOX/NewFolder";
    $result = imap_createmailbox($imap_stream, $mailbox);

    if ($result) {
        echo "建立郵箱成功！";
    } else {
        echo "建立郵箱失敗！";
    }

    // 關閉 IMAP 連線
    imap_close($imap_stream);
} else {
    echo "無法連線到 IMAP 伺服器！";
}

注意事項：

• 連線到 IMAP 伺服器之後，使用 imap_createmailbox() 函式建立郵箱之前，應該先呼叫 imap_open() 函式進行身份驗證和連線。
• 在指定的郵箱路徑中，可以使用斜槓（/）作為層級分隔符，例如 "INBOX/Folder/Subfolder"。
• 如果指定的郵箱路徑中的資料夾不存在，將會自動建立它。
• 要建立的郵箱路徑應該是相對於根目錄（INBOX）的相對路徑，或者是完整的絕對路徑。
• 若要建立的郵箱路徑包含特殊字元（如空格、中文等），應該使用 IMAP UTF-7 編碼進行轉換。
• 如果建立郵箱成功，返回 true；如果建立失敗，返回 false。