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。