Edit Report a Bug

    imap_clearflag_full

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

    imap_clearflag_full — Löscht die Flags einer Nachricht

    Beschreibung

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

    Diese Funktion bewirkt bei den mit sequence spezifizerten Nachrichten das Löschen der in flag angegebenen Flags.

    Parameter-Liste

    imap

    Eine IMAP\Connection-Instanz.

    sequence

    Eine Reihe von Nachrichtennummern. Diese können als Aufzählung in der Form X,Y oder als Intervall in der Form X:Y angegeben werden.

    flag

    Die folgenden Flags werden unterstüzt: "\\Seen", "\\Answered", "\\Flagged", "\\Deleted" und "\\Draft" (siehe auch » RFC2060)

    options

    options ist eine Bitmaske und kann nur die folgende Option enthalten:

    • ST_UID - der Parameter sequence besteht aus UIDs anstelle von Nachrichtennummern.

    Rückgabewerte

    Gibt immer true zurück.

    Fehler/Exceptions

    Wenn options ungültig ist, wird ein ValueError geworfen.

    Changelog

    Version Beschreibung
    8.1.0 Der Parameter imap erwartet nun eine IMAP\Connection-Instanz; vorher wurde eine gültige imap-Ressource erwartet.
    8.0.0 Bei ungültigen Parameterwerten von options wird nun ein ValueError geworfen; zuvor wurde eine Warnung ausgegeben und die Funktion gab false zurück.

    Siehe auch

    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
    19 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