imap_delete

(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] )

Marque les messages msg_number pour l'effacement. 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 .

Liste de paramètres

imap_stream

Un flux IMPA retourné par la fonction imap_open() .

msg_number

Le numéro du message

options

Vous pouvez le définir à FT_UID qui demande à la fonction de traiter l'argument msg_number comme un UID .

Valeurs de retour

Retourne TRUE .

Exemples

Exemple 1198. Exemple avec imap_delete()

<?php

$mbox 
imap_open ( "{imap.example.org}INBOX" "username" "password" )
    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 );
?>

Notes

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.

Voir aussi

imap_undelete()
imap_expunge()
imap_close()