imap_renamemailbox

(PHP 4, PHP 5)

imap_renamemailbox — Rename an old mailbox to new mailbox

说明

bool imap_renamemailbox ( resource $imap_stream , string $old_mbox , string $new_mbox )

This function renames on old mailbox to new mailbox (see imap_open() for the format of mbox names).

参数

imap_stream: 由 imap_open() 返回的 IMAP 流。
old_mbox: The old mailbox name, see imap_open() for more information
new_mbox: The new mailbox name, see imap_open() for more information

返回值

成功时返回 TRUE，或者在失败时返回 FALSE.

参见

imap_createmailbox() - Create a new mailbox
imap_deletemailbox() - Delete a mailbox

PHP手册 - N: Rename an old mailbox to new mailbox

用户评论:

Christoffer Lindahl (12-Oct-2010 06:27)

Don't forget that you can't be connected to the mailbox that you are going to rename (or delete). If you have the following mailboxes: INBOX INBOX.Foo ...and want to rename "INBOX.Foo" to "INBOX.Bar" you have to be connected to "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); ?>

josh at paducahwebpublishing dot com (03-Mar-2000 08:13)

Don't let "...string old_mbox, string new_mbox);" fool you. You have to add the server and port to the mailbox name also. So it would be something like: imap_renamemailbox($mailbox, "{localhost:143}$oldfolder", "{localhost:143}$newfolder") Just thought I would point it out, it took me a while to figure it out.