imap_append

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

    imap_append — Ajoute un message dans une boîte aux lettres

    Description

    imap_append(
        IMAP\Connection$imap,
        string$folder,
        string$message,
        ?string$options = null,
        ?string$internal_date = null
    ): bool

    Ajoute un message au folder spécifié.

    Liste de paramètres

    imap

    Une instance de IMAP\Connection.

    folder

    Le nom de la boîte aux lettres, voir la documentation sur la fonction imap_open() pour plus d'informations

    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é.

    message

    Le message à ajouter, sous la forme d'une chaîne de caractères

    Lors des échanges avec le serveur Cyrus IMAP, vous devrez utiliser "\r\n" comme terminaison de ligne, à la place de "\n" ou l'opération échouera.

    options

    Si fourni, le paramètre options sera également écrit dans la boîte folder

    internal_date

    Si ce paramètre est défini, il mettra les INTERNALDATE sur le message joint. Le paramètre doit être une chaîne de date qui est conforme aux spécifications du rfc2060 pour une valeur date_time.

    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.
    8.0.0options et internal_date sont désormais nullable.

    Exemples

    Exemple #1 Exemple avec imap_append()

    <?php
    $imap     = imap_open("{imap.example.org}INBOX.Drafts", "username", "password");

    $check = imap_check($imap);
    echo     "Msg Count before append: ". $check->Nmsgs . "\n";

    imap_append($imap, "{imap.example.org}INBOX.Drafts"
    , "From: me@example.com\r\n"
    . "To: you@example.com\r\n"
    . "Subject: test\r\n"
    . "\r\n"
    . "Ceci est un message de test. Ignorez le.\r\n"
    );

    $check = imap_check($imap);
    echo     "Nombre de messages après ajout : ". $check->Nmsgs . "\n";

    imap_close($imap);
    ?>
    To Top