imap_delete

(PHP 3, PHP 4 , PHP 5)

imap_delete --  Marque le fichier pour l'effacement, dans la boîte aux lettres courante

Description

bool imap_delete ( int imap_stream, int msg_number [, int options] )

imap_delete() retourne TRUE.

imap_delete() marque le fichier msg_number pour l'effacement, dans la boîte aux lettres courante. Le paramètre optionnel flags ne prend qu'une seule valeur, ft_uid, qui indique à PHP qu'il faut traiter msg_number comme un uid. L'effacement réel n'interviendra que lors de l'appel de la fonction imap_expunge() ou de imap_close() avec le paramètre optionnel CL_EXPUNGE.

Note : Les boîtes aux lettres POP3 n'ont pas les flags de leurs messages de sauvegardés entre les connexions, donc, la fonction imap_expunge() doit être appelée pendant la même connexion pour que les messages marquées pour effacement soient réellement purgés.

Exemple 1. Exemple avec imap_delete()

<?php

$mbox
= imap_open("{your.imap.host}INBOX", "utilisateur", "mot_de_passe")
   or die (
"connexion impossible: " . imap_last_error());
   
$check = imap_mailboxmsginfo($mbox);
echo
"Nombre de messages avant effacement  : " . $check->Nmsgs . "<br />\n" ;

imap_delete($mbox, 1);

$check = imap_mailboxmsginfo ($mbox);
echo
"Nombre de messages après effacement: " . $check->Nmsgs . "<br />\n" ;

imap_expunge ($mbox);

$check = imap_mailboxmsginfo ($mbox);
echo
"Nombre de messages après imap_expunge: " . $check->Nmsgs . "<br />\n" ;

imap_close ($mbox);
?>

Voir aussi imap_undelete(), imap_expunge() et imap_close().