Précédent   LXVII. IMAP  Suivant

imap_createmailbox

(PHP 4, PHP 5)

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

Description

bool imap_createmailbox ( resource $imap_stream, string $mailbox )

Crée une nouvelle boîte aux lettres nommée mailbox .

Liste de paramètres

imap_stream

Un flux IMPA retourné par la fonction imap_open() .

mailbox

Le nom de la boîte aux lettres, voir la documentation sur la fonction imap_open() pour plus d'informations. Les noms contenant des caractères internationaux doivent être encodés par la fonction imap_utf7_encode()

Valeurs de retour

Cette fonction retourne TRUE en cas de succès, FALSE en cas d'échec.

Exemples

Exemple 1197. Exemple avec imap_createmailbox()

<?php
$mbox  =  imap_open ( "{imap.example.org}" ,  "username" ,  "password" ,  OP_HALFOPEN )
     or die( "connexion impossible : "  .  imap_last_error ());

 $name1  =  "phpnewbox" ;
 $name2  =  imap_utf7_encode ( "phpnewb&ouml;x" );

 $newname  =  $name1 ;

echo  "Le nouveau nom sera '$name1'<br />\n" ;

 // Nous allons créer maintenant une nouvelle boîte aux lettres "phptestbox"
// dans votre dossier inbox, vérifier son état et, finalement, la supprimer
// pour remettre votre inbox dans son état initial.

 if (@ imap_createmailbox ( $mbox ,  imap_utf7_encode ( "{imap.example.org}INBOX.$newname" ))) {
     $status  = @ imap_status ( $mbox ,  "{imap.example.org}INBOX.$newname" ,  SA_ALL );
    if ( $status ) {
        echo  "Votre nouvelle boîte '$name1' est dans l'état suivant :<br />\n" ;
        echo  "Messages :   "  .  $status -> messages     .  "<br />\n" ;
        echo  "Récent :     "  .  $status -> recent       .  "<br />\n" ;
        echo  "Non lus :     "  .  $status -> unseen       .  "<br />\n" ;
        echo  "UIDnext :    "  .  $status -> uidnext      .  "<br />\n" ;
        echo  "UIDvalidity :"  .  $status -> uidvalidity  .  "<br />\n" ;

        if ( imap_renamemailbox ( $mbox ,  "{imap.example.org}INBOX.$newname" ,  "{imap.example.org}INBOX.$name2" )) {
            echo  "renommage de la boîte aux lettres '$name1' en '$name2'<br />\n" ;
             $newname  =  $name2 ;
        } else {
            echo  "imap_renamemailbox sur la nouvelle boîte aux lettres a échoué : "  .  imap_last_error () .  "<br />\n" ;
        }
    } else {
        echo  "imap_status sur la nouvelle boîte aux lettres a échoué : "  .  imap_last_error () .  "<br />\n" ;
    }

    if (@ imap_deletemailbox ( $mbox ,  "{imap.example.org}INBOX.$newname" )) {
        echo  "nouvelle boite aux lettres supprimée pour remettre tout en état<br />\n" ;
    } else {
        echo  "imap_deletemailbox sur la nouvelle boîte aux lettres a échoué : "  .  implode ( "<br />\n" ,  imap_errors ()) .  "<br />\n" ;
    }

} else {
    echo  "Impossible de créer une nouvelle boîte aux lettres : "  .  implode ( "<br />\n" ,  imap_errors ()) .  "<br />\n" ;
}

 imap_close ( $mbox );
 ?>

Voir aussi

imap_renamemailbox()
imap_deletemailbox()

Précédent   Niveau supérieur  Suivant
imap_close  Sommaire  imap_delete