PHP Conference Japan 2024

imap_renamemailbox

(PHP 4, PHP 5, PHP 7, PHP 8)

imap_renamemailbox將舊的信箱重新命名為新的信箱

說明

imap_renamemailbox(IMAP\Connection $imap, string $from, string $to): bool

此函式將舊的信箱重新命名為新的信箱(有關 mbox 名稱的格式,請參閱 imap_open())。

參數

imap

一個 IMAP\Connection 實例。

from

舊的信箱名稱,更多資訊請參閱 imap_open()

警告

將不可信的資料傳遞給此參數是不安全的,除非 imap.enable_insecure_rsh 已被停用。

新的信箱名稱,詳情請參閱 imap_open()

警告

將不可信的資料傳遞給此參數是不安全的,除非 imap.enable_insecure_rsh 已被停用。

返回值

成功時返回 true,失敗時返回 false

更新日誌

版本 說明
8.1.0 imap 參數現在需要一個 IMAP\Connection 實例;先前需要一個有效的 imap 資源

另請參閱

新增註解

使用者貢獻的註解 2 則註解

josh at paducahwebpublishing dot com
24 年前
別被 "...string old_mbox, string new_mbox);" 給騙了。您還必須將伺服器和埠添加到信箱名稱中。所以它會像這樣

imap_renamemailbox($mailbox, "{localhost:143}$oldfolder", "{localhost:143}$newfolder")

只是想指出這一點,我花了一段時間才弄清楚。
Christoffer Lindahl
14 年前
別忘了,您不能連接到您要重新命名(或刪除)的信箱。

如果您有以下信箱
INBOX
INBOX.Foo

...並且想要將 "INBOX.Foo" 重新命名為 "INBOX.Bar",您必須連接到 "INBOX"

<?php
$mbox
= imap_open('{imap.example.com}INBOX', 'username', 'password');
imap_renamemailbox($mbox, '{imap.example.com}INBOX.Foo', '{imap.example.com}INBOX.Bar');
imap_close($mbox);
?>
To Top