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 ( resource $imap_stream , int $msg_number [, int $options = 0 ] )

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 IMAP 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 #1 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 IMAP 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() - Enlève la marque d'effacement d'un message
imap_expunge() - Efface tous les messages marqués pour l'effacement
imap_close() - Termine un flux IMAP