imap_delete

(PHP 3, PHP 4, PHP 5)

imap_delete - помечает сообщение на удаление из текущего mailbox.

Описание

int imap_delete (int imap_stream, int msg_number [, int flags])

Возвращает TRUE.

imap_delete() помечает на удаление сообщения. перечисленные в msg_number. Необязательный параметр flags имеет только одну опцию, FT_UID, которая говорит функции, что нужно рассматривать аргумент msg_number как UID. Сообщения, помеченные на удаление, будут оставаться в mailbox до тех пор, пока не будет вызвана imap_expunge() или imap_close() с опцией CL_EXPUNGE.

Примечание: POP3 mailbox'ы не сохраняют свои флаги в промежутке между соединениями, поэтому imap_expunge() обязана вызываться в ходе того же соединения, чтобы сообщения, помеченные на удаление, действительно были вычищены.

Пример 1. imap_delete()

$mbox = imap_open("{imap.example.org}INBOX", "username", "password")
    or die("Can't connect: " . imap_last_error());

$check = imap_mailboxmsginfo($mbox);
echo "Messages before delete: " . $check->Nmsgs . "<br />\n";

imap_delete($mbox, 1);

$check = imap_mailboxmsginfo($mbox);
echo "Messages after  delete: " . $check->Nmsgs . "<br />\n";

imap_expunge($mbox);

$check = imap_mailboxmsginfo($mbox);
echo "Messages after expunge: " . $check->Nmsgs . "<br />\n";

imap_close($mbox);