PHP 8.4.0 RC2 available for testing

imap_setflag_full

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

imap_setflag_fullİletileri imler

Açıklama

imap_setflag_full(
    IMAP\Connection $imap,
    string $aralık,
    string $im,
    int $seçenekler = 0
): true

Belirtilen aralık içindeki iletilerin imlerine belirtilen im imini ekler.

Bağımsız Değişkenler

imap

IMAP\Connection nesnesi.

aralık

İleti numaraları aralığı. İmlenecek iletileri X,Y biçeminde sıralayabilir veya X:Y biçeminde bir aralık olarak belirtebilirsiniz.

im

» RFC 2060 tarafından tanımlanmış şu imler belirtilebilir: \Seen (okundu), \Answered (yanıtlandı), \Flagged (imlendi), \Deleted (silindi) ve \Draft (taslak).

seçenekler

Şu seçeneklerden sadece birini içerebilir:

  • ST_UID - aralık bağımsız değişkeni sıra numaraları yerine eşsiz kimlikleri içerir.

Dönen Değerler

Daima true döndürür.

Hatalar/İstisnalar

seçenekler geçersiz ise ValueError oluşur.

Sürüm Bilgisi

Sürüm: Açıklama
8.0.0 seçenekler geçersiz ise artık ValueError oluşuyor. Evvelce, bir uyarı verilir ve işlev false döndürürdü.
8.1.0 imap bağımsız değişkeni artık IMAP\Connection nesnesi kabul ediyor, evvelce resource türünde geçerli bir imap değeri kabul ederdi.

Örnekler

Örnek 1 - imap_setflag_full() örneği

<?php
$pk
= imap_open("{imap.example.org:143}", "birey", "parola")
or die(
"bağlanılamadı: " . imap_last_error());

$durum = imap_setflag_full($pk, "2,5", "\\Seen \\Flagged");

echo
gettype($durum) . "\n";
echo
$durum . "\n";

imap_close($pk);
?>

Ayrıca Bakınız

add a note

User Contributed Notes 9 notes

up
25
AJCartmell at ricardo dot com
22 years ago
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!
up
5
daniel dot blackburn at galorwebservices dot com
14 years ago
Where possible I would avoid using POP3 accounts. My host allowed me to upgrade to IMAP and it is so much easier. I think the only way to accurately create any form of mail client with POP3 is to download the messages into an SQL database which is a big task to start with, considering the IMAP standards have the functionality we need built in.
I experimented with flag setting in POP3 and it seems they do not stick at all, and it is almost impossible to retrieve the number of unread messages (ie. the Seen / Unseen thing does not work)
Converted to IMAP and it's working - the majority of the functions in this section seem to be IMAP focussed and WILL NOT generally work with POP3
up
1
php AT holtsmark DOT no
22 years ago
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
up
0
ming0 at mailinator dot com
14 years ago
To correct phpidiot at avanca-a dot de

<?php

imap_setflag_full
($mbox, '1', 'label1');

?>
up
0
phpidiot at avanca-a dot de
14 years ago
"Keywords" aka "tags" aka "PERMANENTFLAGS" can be added if your server supports IMAP 4rev1 by using $label{label-nr}:

<?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", "\$label1");

echo
gettype($status) . "\n";
echo
$status . "\n";

imap_close($mbox);
?>
up
0
death at metalfield dot com
23 years ago
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.
up
-3
simoned at eisa dot net dot au
24 years ago
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.
up
-5
todsah at arise dot nl
24 years ago
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.
up
-4
msh at onliners dot dk
22 years ago
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.
To Top