Edit Report a Bug

    imap_clearflag_full

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

    imap_clearflag_full — Supprime un flag (drapeau) sur un message

    Description

    imap_clearflag_full(
        IMAP\Connection $imap,
        string $sequence,
        string $flag,
        int $options = 0
    ): true

    imap_clearflag_full() efface le flag flag dans les messages de la séquence sequence, du flux imap stream.

    Liste de paramètres

    imap

    Une instance de IMAP\Connection.

    sequence

    Une séquence de numéro de messages. Vous pouvez énumérer les messages désirées avec la syntaxe X,Y, ou récupérer tous les messages contenus dans un intervalle, avec la syntaxe X:Y

    flag

    Les flags flag que vous pouvez effacer sont "\\Seen", "\\Answered", "\\Flagged", "\\Deleted" et "\\Draft" (tels que définis dans la » RFC2060)

    options

    options est un masque de bits, qui accepte uniquement la valeur suivante :

    • ST_UID - la séquence contient des UID au lieu de numéros de séquence

    Valeurs de retour

    Retourne toujours true.

    Erreurs / Exceptions

    Lance une exception ValueError si le paramètre options est invalide.

    Historique

    Version Description
    8.1.0 La paramètre imap attend désormais une instance de IMAP\Connection ; auparavant, une ressource imap était attendue.
    8.0.0 Une exception ValueError est désormais lancée pour des valeurs invalides du paramètre options. Auparavant, un avertissement était émis et la fonction retournait false.

    Voir aussi

    add a note add a note

    User Contributed Notes 5 notes

    up
    2
    Nohado
    14 years ago
    I got a note that:

    if u want to set a mail to "//Unseen", which not exists,
    do it like this:

    imap_clearflag_full($your_imap_connection,
    $number_of_message,"//Seen");

    but, remember to do
    imap_close($imap, CL_EXPUNGE);
    @ the END! so that it will be confirmed!

    Cheers,
    Nohado
    up
    -1
    info at sharoff dot org
    7 years ago
    <?php

    $connection     = imap_open(...);
    $messageUid = 123;

    imap_clearflag_full($connection, $messageUid, '\\Seen', ST_UID);
    up
    -1
    Anonymous
    18 years ago
    imap_clearflag_full() and imap_setflag_full() seem to only change messageflags permanently with IMAP connections, not with POP3 connections.
    up
    -2
    Mark Hill
    15 years ago
    Remember to specify your flags like '\\Seen' rather than "\\Seen".

    Of course, flags are an IMAP feature, not a POP feature.

    Resetting \\Seen works from PHP 4.3 works fine on the modern mail servers I've tested.
    up
    -3
    calmdown at abendstille dot at
    21 years ago
    This function seems not to save the \\Seen flag permanently.

    Testet on Win NT IIS 4.0 PHP 4.3 and imap-mail-server
    add a note add a note
    To Top