PHP: imap_setflag_full - Manual

downloads | documentation | faq | getting help | mailing lists | reporting bugs | php.net sites | links | conferences | my php.net

search for in the

imap_sort imap_setacl

Last updated: Sat, 27 Jan 2007

view this page in

# imap_setflag_full

(PHP 3 >= 3.0.3, PHP 4, PHP 5)

imap_setflag_full -- Sets flags on messages

## Описание

bool imap_setflag_full ( resource imap_stream, string sequence, string flag [, string options] )

Causes a store to add the specified `flag` to the flags set for the messages in the specified `sequence`.

## Список параметров

`imap_stream`

  An IMAP stream returned by 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 set are `\\Seen`, `\\Answered`, `\\Flagged`, `\\Deleted`, and `\\Draft` as defined by RFC2060.

`options`

  A bit mask that may contain the single option:

  - `ST_UID` - The sequence argument contains UIDs instead of sequence numbers

## Возвращаемые значения

Возвращает `TRUE` в случае успешного завершения или `FALSE` в случае возникновения ошибки.

## Примеры

Пример 1. imap_setflag_full() example

`<?php
$mbox = imap_open("{imap.example.org:143}", "username", "password")
or die("can't connect: " . imap_last_error());
$status = imap_setflag_full($mbox, "2,5", "\\Seen \\Flagged");
echo gettype($status) . "\n";
echo $status . "\n";
imap_close($mbox);
?>`

## Смотрите также

imap_clearflag_full()

add a note User Contributed Notes
imap_setflag_full
calmdown at abendstille dot at
16-Jan-2003 01:54
`The imap_setflag_full-function works with pop3 as long as the connection is NOT closed. if you make
imap_setflag_full($mbox, imap_uid($mbox, 0), "\\Seen \\Flagged", ST_UID);
print_r( imap_headerinfo($mbox, 0) );
you see the flags set, but if you call the box again with another script, the flags are empty again.
I tried this on a WinNT (*ugly*) with IIS 4.0 and a running POP3-server with PHP 4.3.`
msh at onliners dot dk
25-Apr-2002 08:36
`In reply to:
todsah@arise.nl
13-Oct-2000 06:51
The pop3 does indeed support the deleted flag - I have been working with the IMAP functions connection to a POP3 server this past week and lucky me it works.`
AJCartmell at ricardo dot com
31-Jan-2002 06:29
`Spent ages trying to get this to work, then eventually remembered I had opened the mailbox READONLY - obviously you need write permission for setting flags!`
php AT holtsmark DOT no
14-Jan-2002 06:48
`Use the imap_clearflag_full function if you want to unset the \Seen flag.
http://www.php.net/manual/en/function.imap-clearflag-full.php`
death at metalfield dot com
21-Dec-2000 05:14
`Indeed POP3 does not support flags that indicate the "newness" of a message. There are other ways to work around this problem, though. For one, I have seen mail delivery systems that will add a header field Status: to indicate its status (see RFC2076). Another way most email clients and mail fetching programs seem to use is to keep a local list of UID's of messages that are downloaded. Upon fetching mail, the UID's of the messages can be checked against this list to see if it was already downloaded. POP3 supports a command UIDL to get a list of all UID's, but I doubt the IMAP lib uses this command. The only thing I know of that will thrash this work-around is the use of multiple mail clients. If another mail client fetches mail from the server, the first client has no way of knowing it has been downloaded.`
todsah at arise dot nl
13-Oct-2000 12:51
`According to the rfc, pop3 does not have support for these flags, except perhaps for the deleted flag. I haven't tried if the delete flag works on pop3 or not.`
simoned at eisa dot net dot au
13-Jan-2000 10:04
`I've finally managed to get some action out of this function. Here is some code that might work help some people out:
$headers = imap_headers($link);
for($x=0; $x < count($headers); $x++) {
$id = substr($headers[$x],5,4);
imap_setflag_full($link,imap_uid($link,$id),'\\SEEN',SE_UID);
}
Good luck.`
add a note
imap_sort imap_setacl

Last updated: Sat, 27 Jan 2007
show source | credits | stats | sitemap | contact | advertising | mirror sites
Copyright © 2001-2007 The PHP Group
All rights reserved.
This mirror generously provided by: Yahoo! Inc.
Last updated: Sat Mar 10 09:32:46 2007 PST