imap_rename()函式—用法及示例

函式名稱：imap_rename()

函式描述：該函式用於重新命名郵件伺服器上的郵箱。

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

語法：bool imap_rename ( resource $imap_stream , string $old_mbox , string $new_mbox )

引數：

• $imap_stream：一個有效的 IMAP 流資源，透過 imap_open() 函式返回。
• $old_mbox：需要重新命名的郵箱名稱，以 IMAP 格式表示。
• $new_mbox：新的郵箱名稱，以 IMAP 格式表示。

返回值：如果成功重新命名郵箱，則返回 true，否則返回 false。

示例：

// 連線到 IMAP 伺服器
$imap_server = '{imap.example.com:993/ssl}';
$username = 'your_username';
$password = 'your_password';
$mailbox = imap_open($imap_server, $username, $password);

if ($mailbox) {
    // 重新命名郵箱
    $old_mailbox = 'INBOX.Old';
    $new_mailbox = 'INBOX.New';
    $result = imap_rename($mailbox, $old_mailbox, $new_mailbox);

    if ($result) {
        echo "郵箱重新命名成功！";
    } else {
        echo "郵箱重新命名失敗！";
    }

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

注意事項：

1. 該函式需要使用 IMAP 擴充套件庫，因此在使用之前，請確保已啟用該擴充套件。
2. 郵箱名稱必須以 IMAP 格式表示，例如 "INBOX" 或 "INBOX.Subfolder"。
3. 在重新命名郵箱時，請確保目標郵箱不存在，否則重新命名將失敗。
4. 連線到 IMAP 伺服器時，必須提供正確的伺服器地址、使用者名稱和密碼。
5. 在使用完 imap_rename() 函式後，應該使用 imap_close() 函式關閉 IMAP 連線。