PHP - imap_mail_copy() 函数

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

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

语法

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

参数

序号	参数和描述
1	imap_stream（必填）这是一个表示 IMAP 流的字符串值，是 imap_open() 函数的返回值。
2	$msglist（必填）这是一个表示消息范围的字符串值。
3	mailbox（必填）这是一个表示邮箱名称/URL 的字符串值。它包含服务器名称、邮箱路径。
4	Options（可选）这是一个表示可选参数的整数值，将是以下一个或多个：− FT_UID CP_MOVE

返回值

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

PHP 版本

此函数最初在 PHP 版本 4 中引入，并在所有后续版本中均有效。

示例

以下示例演示了 **imap_mail_copy()** 函数的使用：−

<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		 
         $msg_list = ["test_string1", "test_string2", "test_string3"];
         //$body = imap_mail_copy($imap, $msg_list, $url);
		 
         $testmailbox = "{imap.gmail.com:993/imap/ssl/novalidate-cert}INBOX.de";
         $res = imap_createmailbox($imap, imap_utf7_encode($testmailbox));
            
         $res = imap_mail_copy($imap, "1", $testmailbox); 
         If($res){
             print("Mail copied successfully");
         }else{
             print("Error Occurred");
         }   
         //Closing the connection
         imap_close($imap);   
      ?>
   </body>
</html>

输出

这将生成以下输出：−

Connection established....
Mail copied 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>");		 
		 
         $mbox = "{imap.gmail.com:993/imap/ssl/novalidate-cert}INBOX.emp";
         imap_createmailbox($imap, imap_utf7_encode($mbox));
         imap_mail_copy($imap, "1", $mbox, CP_MOVE); 
 
         //Closing the connection
         imap_close($imap);   
      ?>
   </body>
</html>

输出

这将生成以下输出：−

Connection established....

php_function_reference.htm

打印页面