Last updated: Fri, 04 Jul 2008

imap_delete

(PHP 4, PHP 5)

imap_delete — Nachrichten im aktuellen Postfach zur Löschung markieren

Beschreibung

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

Die mit msg_number angegebene Nachricht oder Liste von Nachrichten wird zur Löschung vorgemerkt. Entsprechend markierte Nachrichten bleiben zunächst im Postfach erhalten, erst beim Aufruf von imap_expunge() oder beim Schließen der Verbingung mit imap_close() und der CL_EXPUNGE Option werden sie tatsächlich endgültig gelöscht.

Parameter-Liste

imap_stream: Eine von imap_open() zurückgegebene IMAP-Verbindung.
msg_number: Die Nachrichtennummer
options: Mit Hilfe der Option FT_UID kann festgelegt werden das msg_number an Stelle von Nachrichtennummern UIDs enthält.

Rückgabewerte

Returns TRUE.

Beispiele

Beispiel #1 imap_delete() Beispiel


<?php

$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);
?>

Anmerkungen

Hinweis: Für POP3 Postfächer kann das Löschen-Flag nicht serverseitig zwischen Verbindungen gespeichert werden, markierte Nachrichten müssen daher noch wärend der aktuellen Verbindung mit imap_expunge() entfernt werden, ansonsten bleiben sie ohne Löschmarkierung weiter erhalten.

Siehe auch

add a note User Contributed Notes
imap_delete

jacky at jackyhome dot myvnc dot com
09-Nov-2003 10:42


// is not a complete code but enough to clear out an entire mailbox.

// hope this can save your time :-)



<?php



if (isset($_REQUEST['DoNow'])) 

{

  # PULL ADDITIONAL FILES

  include_once ("common.php");

  

  $conn = @imap_open("\{$server/$serverType}Trash", $user, $pass) 

  or die("Connection to folder failed");

  

  $headers = @imap_check($conn);

  ($headers->Nmsgs > 0) or die("Trash is empty already !");

  

  // delete email(s)

  @imap_delete($conn,'1:*');   // to clear out an entire mailbox.

  @imap_expunge($conn);

  echo "Trash is empty."; 

  

  imap_close($conn);

} 

else

{

  echo "<form name='formA' action='".$_SERVER['PATH_INFO']."' method='POST'>"; ?>

  Are you sure to empty trash ?

  <p>

  <input type="submit" value="Go Ahead" name="DoNow">&nbsp;

  <input type="button" value="Cancel" name="Cancel" onClick='javascript:self.history.go(-1)'></form></p>

<?php

} ?>

James G
10-Apr-2003 06:05


I had some major issues deleting emails using this function.  Using IIS 5.0 and a win based Mail Server, I could not delete the emails individually.



My script merely needed to check the emails and update the database for bounce backs, after which I simply wanted to erase all emails.



If imap_delete($mbox,$email->MsgNo) just isnt working for you, you can try using



    imap_delete($mbox,'1:*');



to clear out an entire mailbox.



Hope this helps cause it drove me insane for about 5 hours.  :)

add a note

imap_deletemailbox

imap_createmailbox

Last updated: Fri, 04 Jul 2008