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.