imap_renamemailbox

(PHP 4, PHP 5)

imap_renamemailbox — Renomme une boîte aux lettres

Description

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

imap_renamemailbox() renomme la boîte aux lettres old_mbox en new_mbox (voir la fonction imap_open() pour le format des noms mbox).

Liste de paramètres

imap_stream: Un flux IMAP retourné par la fonction imap_open().
old_mbox: L'ancien nom de la boîte aux lettres, voir la documentation de la fonction imap_open() pour plus de détails
new_mbox: Le nouveau nom de la boîte aux lettres, voir la documentation de la fonction imap_open() pour plus de détails

Valeurs de retour

Cette fonction retourne TRUE en cas de succès ou FALSE si une erreur survient.

Voir aussi

imap_createmailbox() - Crée une nouvelle boîte aux lettres
imap_deletemailbox() - Efface une boîte aux lettres

add a note User Contributed Notes imap_renamemailbox - [2 notes]

down

Christoffer Lindahl ¶

2 years ago


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);


?>

down

josh at paducahwebpublishing dot com ¶

13 years ago


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.

add a note