PHP - Manual: imap_delete

2024-11-14

imap_delete

(PHP 4, PHP 5, PHP 7, PHP 8)

imap_delete — Mark a message for deletion from current mailbox

说明

imap_delete(IMAP\Connection $imap, string $message_nums, int $flags = 0): bool

Marks messages listed in message_nums for deletion. Messages marked for deletion will stay in the mailbox until either imap_expunge() is called or imap_close() is called with the optional parameter CL_EXPUNGE.

参数

imap: IMAP\Connection 实例。
message_nums: A string representing one or more messages in IMAP4-style sequence format ("n", "n:m", or combination of these delimited by commas).
flags: You can set the FT_UID which tells the function to treat the message_nums argument as a UID.

返回值

Returns true.

更新日志

版本	说明
8.1.0	现在 `imap` 参数接受 IMAP\Connection 实例，之前接受资源(resource)。

范例

示例 #1 imap_delete() example


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

注释

注意:
IMAP mailboxes may not have their message flags saved between connections, so imap_expunge() should be called during the same connection in order to guarantee that messages marked for deletion will actually be purged.

参见

imap_undelete() - Unmark the message which is marked deleted
imap_expunge() - Delete all messages marked for deletion
imap_close() - Close an IMAP stream

add a note

User Contributed Notes 10 notes

down

erational ¶

9 years ago


the function is using the message number (and not the uid !)
$uid = $mail->uid; 
$msgno = $mail->msgno;

if you want to use the uid, simply option value
imap_delete($mbox, $uid, FT_UID);

down

rueda dot raul at gmail dot com ¶

8 years ago


This function seems not to work on "[Gmail]/All Mail" mailbox. This is because Gmails keeps only one copy of the message and mailboxes are no more than labels. 
Deleting a message from a mailbox only removes that label (except for "All Mail" mailbox).
To delete from "All Mail" you have to use imap_mail_move() function and move the message to "[Gmail]/Trash" mailbox.

Note: Names of mailboxes in Gmail depends on the language you're using.  E.g.: in Spanish "All Mail" is "Todos" and "Trash" is "Papelera".

down

chris at financialservicesonline dot com dot au ¶

13 years ago


After a little experimentation i found out how to mark a single message for deletion...

<?php

$msgid = '5'; //For example

imap_delete($mbox, "$msgid:$msgid");

?>

imap_delete() seems to want a range, so to select one, simply range from your id to your id.

Hope this helps.

down

Daniel Dafoe ¶

6 years ago


Just so anyone using this function is aware: if you mark an email to be deleted from a mailbox, that flag does not persist. You need to call imap_expunge() or use the  CL_EXPUNGE option with imap_close() to remove the marked email in the same PHP script you marked it in.

I hope this helps someone out.

down

Olle ¶

9 years ago


I couldn't get imap_delete to work when I used it with pop3. Instead i wrote:
<?php
function pop3_dele($connection,$message)
{
    $status = imap_setflag_full($connection, '1:'.$message, '\\Deleted');
    imap_expunge($connection);
    return $status;

    //return(imap_delete($connection,trim($message)));
}
?>

down

thisemailaddress at gmail dot com ¶

12 years ago


In case you feel the need to kill all emails from before a certain year on your Gmail account, this would work:


<?php

error_reporting(E_ALL ^ (E_NOTICE | E_WARNING));


echo "parsing ini file...\n";

$ini = parse_ini_file('g.ini');

$user = $ini['user'];

$pass = $ini['pass'];

$year = $ini['year'];

echo "account {$user} - killing msgs from before {$year}\n\n";


echo "connecting...\n";

$imap = imap_open("{imap.gmail.com:993/imap/ssl/novalidate-cert}[Gmail]/All Mail", $user, $pass) or die("can't connect: " . imap_last_error() . "\n");


echo "checking current mailbox...\n";

$mbox = imap_check($imap);


echo "fetching overview...\n";

$flaggedForDelete = 0;

for($n = 0; $n < $mbox->Nmsgs; $n++) {

    echo "processing {$n} of {$mbox->Nmsgs}...\r";

    $hdr = imap_fetchheader($imap, $n);

    preg_match('/^Date: (.*?)$/m', $hdr, $matches);

    $date = date_parse(strtotime($matches[1]));

    if($date['year'] < $year) {

        imap_delete($imap, $msg->msgno);

        $flaggedForDelete++;

    }

}


echo "expunging mailbox ({$flaggedForDelete} messages flagged)... ";

echo ((imap_expunge($imap)) ? "ok" : "failed!")."\n";

imap_close($imap);


?>

down

iwantsimplelife at lycos dot com ¶

13 years ago


Somehow, when ever I try to delete an email using the message number returned by imap_header, any email with a message number below 999 will fail.

I discovered that the imap_header will pad the message number with spaces. You will need to trim the number before calling imap_delete.

I am using qmail and it took me over a month to figure it out.

Hope this will be helpful to some poor soul out there facing the same problem.

down

jacky at jackyhome dot myvnc dot com ¶

18 years ago


// 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
} ?>

down

James G ¶

19 years ago


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.  :)

down

-3

Alex ¶

13 years ago


I think you don't have to give a range to imap_delete() if you want to delete a single one. 

This works well:

<?php

imap_delete($conn,trim($msgno));    

?>

add a note

官方地址：https://www.php.net/manual/en/function.imap-delete.php

有任何技术问题请点击这里网站运营推广招聘

IT PHP 编程语言 Linux 开发编程科技 Elasticsearch HTML/CSS/XML 网络 JAVA NoSQL 数据库面试 C/C++ Golang Git 算法操作系统正则表达式 Redis 互联网 MySql JavaScript 运维软件国际架构设计 Mac OS TCP/IP Excel Vim Windows Socket Oracle VR MongoDB Python 运营 MemCache 商业硬件电子娱乐设计 nginx 摄影游戏 WordPress HTTP 团建数码电器

php7 安装fileinfo扩展 preg_split — 通过一个正则表达式分隔字符串 php位值,解决 PHP 中 usort 在值相同时改变原始位置的问题 [PHP] inet_pton/inet_ntop IP地址转换函数 array_multisort() 多字段排序 PHPMailer设置utf8 PHPMailer字符集CharSet ADORecordSet对象 adodb手册 PHP 8.1 [鸟哥]PHP_INT_MIN 和 -9223372036854775808 opcache预加载 Composer的Packagist资源 mysql面试题 [鸟哥]PHP FFI详解 - 一种全新的PHP扩展方式 PHP7添加redis扩展 PHP mkdir()写出来的权限与mode值不符合 Packagist / Composer 中国全量镜像 PHP获取指定函数定义在哪个文件中及行号支持php7的性能采集扩展 adodb连接mysql多个数据库的问题

略微加速

PHP官方手册 - 互联网笔记

imap_delete

说明

参数

返回值

更新日志

范例

注释

参见

User Contributed Notes 10 notes