PHP - Função imap_mail_copy ()

As funções PHP-IMAP ajudam você a acessar contas de e-mail, IMAP significa IInternet Maflição Acesso Protocol usando essas funções, você também pode trabalhar com NNTP, protocolos POP3 e métodos de acesso à caixa de correio local.

o imap_mail_copy() A função aceita um valor de recurso que representa um fluxo IMAP, dois valores de string que representam o intervalo de mensagens e o nome / url da caixa de correio como parâmetros e copia as mensagens especificadas para a caixa de correio fornecida.

Sintaxe

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

Parâmetros

Sr. Não	Parâmetro e Descrição
1	imap_stream (Mandatory) Este é um valor de string que representa um fluxo IMAP, valor de retorno do imap_open() função.
2	$msglist (Mandatory) Este é um valor de string que representa o intervalo das mensagens.
3	mailbox(Mandatory) Este é um valor de string que representa o nome / URL da caixa de correio. Ele contém o nome do servidor e o caminho da caixa de correio.
4	Options (Optional) Este é um valor inteiro que representa os parâmetros opcionais que serão um ou mais dos seguintes - FT_UID CP_MOVE

Valores Retornados

Esta função retorna um valor booleano que é TRUE em caso de sucesso e FALSE em caso de falha.

Versão PHP

Esta função foi introduzida pela primeira vez no PHP Versão 4 e funciona em todas as versões posteriores.

Exemplo

O exemplo a seguir demonstra o uso do imap_mail_copy() função -

<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>

Resultado

Isso irá gerar a seguinte saída -

Connection established....
Mail copied successfully

Exemplo

A seguir está um exemplo da função acima com parâmetros opcionais -

<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>

Resultado

Isso irá gerar a seguinte saída -

Connection established....

↰ Previous page