imap_createmailbox

(PHP 3, PHP 4 )

imap_createmailbox -- Crée une nouvelle boîte aux lettres

Description

bool imap_createmailbox ( resource imap_stream, string mbox)

imap_createmailbox() crée une nouvelle boîte aux lettres nommée mbox. Les noms contenant des caractères spéciaux doivent être encodés.

imap_createmailbox() retourne TRUE en cas de succès, et FALSE en cas d'erreur.

Exemple 1. Exemple avec imap_createmailbox()

<?php
$mbox
= imap_open("{your.imap.host}","utilisateur","mot_de_passe",OP_HALFOPEN)
    or die(
"connexion impossible: ".imap_last_error());
$name1 = "nouvellephpbox";
$name2 = imap_utf7_encode("nouvellephpbox&eacute;x");
$newname = $name1;
echo
"Le nouveau nom sera '$name1'<BR>\n";
// Nous allons cr&eacute;er maintenant une nouvelle bo&icirc;te aux lettres "phptestbox"
// dans votre dossier inbox, v&eacute;rifier son &eacute;tat et finalement, la supprimer
// pour remettre votre inbox dans son &eacute;tat initial.
if(@imap_createmailbox($mbox,imap_utf7_encode("{your.imap.host}INBOX.$newname"))){
$status = @imap_status($mbox,"{your.imap.host}INBOX.$newname",SA_ALL);
if(
$status) {
   print(
"Votre nouvelle bo&icirc;te '$name1' est dans l'&eacute;tat suivant :<BR>\n");
   print(
"Messages:   ". $status->messages   )."<BR>\n";
   print(
"R&eacute;cent:     ". $status->recent     )."<BR>\n";
   print(
"Non lus:     ". $status->unseen     )."<BR>\n";
   print(
"UID suivant:    ". $status->uidnext    )."<BR>\n";
   print(
"UID validit&eacute;:". $status->uidvalidity)."<BR>\n";
   if(
imap_renamemailbox($mbox,"{your.imap.host}INBOX.$newname","{your.imap.host}INBOX.$name2")) {
     echo
"renommage de la bo&icirc;te aux lettres '$name1' en '$name2'<BR>\n";
     
$newname=$name2;
   } else {
     print
"imap_renamemailbox sur la nouvelle bo&icirc;te aux lettres a &eacute;chou&eacute; : ".imap_last_error()."<BR>\n";
   }
} else {
   print  
"imap_status sur la nouvelle bo&icirc;te aux lettres a &eacute;chou&eacute; : ".imap_last_error()."<BR>\n";
}
if(@
imap_deletemailbox($mbox,"{your.imap.host}INBOX.$newname")) {
   print
"new mailbox supprim&eacute;e pour remettre tout en &eacute;tat<BR>\n";
} else {
   print  
"imap_deletemailbox ur la nouvelle bo&icirc;te aux lettres a &eacute;chou&eacute; : ".implode("<BR>\n",imap_errors())."<BR>\n";
}
} else {
print  
"Impossible de cr&eacute;er une nouvelle bo&icirc;te aux lettres : ".implode("<BR>\n",imap_errors())."<BR>\n";
}
imap_close($mbox);
?>

Voir aussi imap_renamemailbox(), imap_deletemailbox() et imap_open() pour connaître le format des noms de mbox.