imap_clearflag_full
(PHP 4, PHP 5)
imap_clearflag_full — Clears flags on messages
Описание
$imap_stream
, string $sequence
, string $flag
[, int $options
= 0
] )
This function causes a store to delete the specified
flag
to the flags set for the
messages in the specified sequence
.
Список параметров
-
imap_stream
-
Поток IMAP, полученный из imap_open().
-
sequence
-
A sequence of message numbers. You can enumerate desired messages with the X,Y syntax, or retrieve all messages within an interval with the X:Y syntax
-
flag
-
The flags which you can unset are "\\Seen", "\\Answered", "\\Flagged", "\\Deleted", and "\\Draft" (as defined by » RFC2060)
-
options
-
options
are a bit mask and may contain the single option:-
ST_UID
- The sequence argument contains UIDs instead of sequence numbers
-
Возвращаемые значения
Возвращает TRUE
в случае успешного завершения или FALSE
в случае возникновения ошибки.
- PHP Руководство
- Функции по категориям
- Индекс функций
- Справочник функций
- Расширения для работы с почтой
- IMAP, POP3 и NNTP
- imap_8bit
- imap_alerts
- imap_append
- imap_base64
- imap_binary
- imap_body
- imap_bodystruct
- imap_check
- imap_clearflag_full
- imap_close
- imap_create
- imap_createmailbox
- imap_delete
- imap_deletemailbox
- imap_errors
- imap_expunge
- imap_fetch_overview
- imap_fetchbody
- imap_fetchheader
- imap_fetchmime
- imap_fetchstructure
- imap_fetchtext
- imap_gc
- imap_get_quota
- imap_get_quotaroot
- imap_getacl
- imap_getmailboxes
- imap_getsubscribed
- imap_header
- imap_headerinfo
- imap_headers
- imap_last_error
- imap_list
- imap_listmailbox
- imap_listscan
- imap_listsubscribed
- imap_lsub
- imap_mail_compose
- imap_mail_copy
- imap_mail_move
- imap_mail
- imap_mailboxmsginfo
- imap_mime_header_decode
- imap_msgno
- imap_num_msg
- imap_num_recent
- imap_open
- imap_ping
- imap_qprint
- imap_rename
- imap_renamemailbox
- imap_reopen
- imap_rfc822_parse_adrlist
- imap_rfc822_parse_headers
- imap_rfc822_write_address
- imap_savebody
- imap_scan
- imap_scanmailbox
- imap_search
- imap_set_quota
- imap_setacl
- imap_setflag_full
- imap_sort
- imap_status
- imap_subscribe
- imap_thread
- imap_timeout
- imap_uid
- imap_undelete
- imap_unsubscribe
- imap_utf7_decode
- imap_utf7_encode
- imap_utf8
Коментарии
This function seems not to save the \\Seen flag permanently.
Testet on Win NT IIS 4.0 PHP 4.3 and imap-mail-server
imap_clearflag_full() and imap_setflag_full() seem to only change messageflags permanently with IMAP connections, not with POP3 connections.
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.
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
<?php
$connection = imap_open(...);
$messageUid = 123;
imap_clearflag_full($connection, $messageUid, '\\Seen', ST_UID);