©
                    本文档使用
                    php中文网手册 发布
                
(PHP 4, PHP 5, PHP 7)
imap_renamemailbox — Rename an old mailbox to new mailbox
$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 。
  
[#1] Christoffer Lindahl [2010-10-12 10:27:34]
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);
?>
[#2] josh at paducahwebpublishing dot com [2000-03-03 00:13:08]
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.