imap_createmailbox

    (PHP 4, PHP 5, PHP 7, PHP 8)

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

    Description

    imap_createmailbox(IMAP\Connection$imap, string$mailbox): bool

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

    Liste de paramètres

    imap

    Une instance de IMAP\Connection.

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

    Avertissement

    Passer des données qui ne sont pas digne de confiance à ce paramètre est dangereux, sauf si, imap.enable_insecure_rsh est désactivé.

    Valeurs de retour

    Cette fonction retourne true en cas de succès ou false si une erreur survient.

    Historique

    VersionDescription
    8.1.0 La paramètre imap attend désormais une instance de IMAP\Connection ; auparavant, une ressourceimap était attendue.

    Exemples

    Exemple #1 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öx"); // phpnewb&w7Y-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

    To Top