PHP - imap_mail_move() 函数



PHP 的 IMAP 函数帮助您访问电子邮件帐户,IMAP 代表 **I**nternet **M**ail **A**ccess **P**rotocol,使用这些函数,您还可以使用 NNTP、POP3 协议和本地邮箱访问方法。

imap_mail_move() 函数接受表示 IMAP 流的资源值、表示消息范围的两个字符串值和邮箱名称/URL 作为参数,并将指定的消息移动到给定的邮箱。

语法

imap_mail_move($imap_stream, $msglist , $mailbox [,$options]);

参数

序号 参数和描述
1

imap_stream (必填)

这是一个字符串值,表示 IMAP 流,是 imap_open() 函数的返回值。

2

msglist (必填)

这是一个字符串值,表示消息的范围。

3

mailbox (必填)

这是一个字符串值,表示邮箱的名称/URL。它包含服务器名称和邮箱路径。

4

Options (可选)

这是一个整数值,表示可选参数,将为 CP_UID。

返回值

此函数返回一个布尔值,成功时为 TRUE,失败时为 FALSE。

PHP 版本

此函数首次在 PHP 4 版本中引入,并在所有后续版本中有效。

示例

此示例演示了 imap_mail_move() 函数的用法:

<html>
   <body>
      <?php
         //Establishing connection
         $url = "{imap.gmail.com:993/imap/ssl/novalidate-cert}INBOX";
         $id = "[email protected]";
         $pwd = "cohondob_123";
         $imap = imap_open($url, $id, $pwd);
         print("Connection established...."."<br>");
		 
         //Copying the messages		 	 
         $testmailbox = "{imap.gmail.com:993/imap/ssl/novalidate-cert}INBOX.de";
         //$res = imap_createmailbox($imap, imap_utf7_encode($testmailbox));
            
         imap_mail_move($imap, "1,2,3", $testmailbox); 
         If($res){
            print("Mail moved successfully");
         }else{
            print("Error Occurred");
         }    
         //Closing the connection
         imap_close($imap);   
      ?>
   </body>
</html>

输出

这将生成以下输出:

Mail moved successfully

示例

以下是带有可选参数的上述函数示例:

<html>
   <body>
      <?php
         //Establishing connection
         $url = "{imap.gmail.com:993/imap/ssl/novalidate-cert}INBOX";
         $id = "[email protected]";
         $pwd = "cohondob_123";
         $imap = imap_open($url, $id, $pwd);
         print("Connection established...."."<br>");
	 	   
         $list = imap_uid($imap, 2)."".imap_uid($imap, 5);	 
         $res = imap_mail_move($imap, $list, $testmailbox, CP_UID ); 
	
         //Closing the connection
         imap_close($imap);   
      ?>
   </body>
</html>

输出

这将生成以下输出:

Connection established....
php_function_reference.htm
广告