PHP - Função imap_append ()

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_append() A função aceita um valor de recurso que representa um fluxo IMAP e dois outros valores de string que representam um nome / URL de caixa de correio e, uma mensagem como parâmetros, anexa a mensagem fornecida à caixa de correio especificada.

imap_binary() function notranslate "> imap_append ($ imap_stream, $ mailbox, $ message [$ options, $ internal_date]);

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	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.
3	message(Mandatory) Este é um valor de string que representa a mensagem a ser anexada.
4	options (Optional) Este é um valor de string opcional que será anexado à caixa de correio especificada.
5	date (Optional) Este é um valor de string que representa a data interna opcional, que deve ser adicionada à mensagem.

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_append() função -

<html>
   <body>
      <?php
         $url = "{imap.gmail.com:993/imap/ssl/novalidate-cert}INBOX";
         $id = "[email protected]";
         $pwd = "cohondob_123";
         $stream = imap_open($url, $id, $pwd);
         print("Connection established....");
         print("<br>");
		 
         $num = imap_num_msg($stream);
         print("Number of messages: ".$num."\n");

         imap_append($stream, $url
            , "From: [email protected]\r\n"
            . "To: [email protected]\r\n"
            . "Subject: test\r\n"
            . "\r\n"
            . "this is a test message, please ignore\r\n"
         );
         print("<br>");
         print("Number of messages after append: ".imap_num_msg($stream)."\n");

         imap_close($stream);
      ?>
   </body>
</html>

Resultado

Isso gera a seguinte saída -

Connection established....
Number of messages: 10
Number of messages after append: 11

Exemplo

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

<html>
   <body>
      <?php
         $url = "{imap.gmail.com:993/imap/ssl/novalidate-cert}INBOX";
         $id = "[email protected]";
         $pwd = "cohondob_123";
         $stream = imap_open($url, $id, $pwd);
         print("Connection established....");
         print("<br>");
		 
         $num = imap_num_msg($stream);
         print("Number of messages: ".$num."\n");

         $msg = "From: [email protected]\r\n"
            . "To: [email protected]\r\n"
            . "Subject: test\r\n"
            . "\r\n"
            . "this is a test message, please ignore\r\n";

         imap_append($stream, $url, $msg, "", date("2/2/2020"));
         print("Message appended");
         imap_close($stream);
      ?>
   </body>
</html>

Resultado

Isso irá gerar a seguinte saída -

Message appended

↰ Previous page