PHP - Função imap_setflag_full ()

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_setflag_full() A função aceita um valor de recurso que representa um fluxo IMAP, dois valores de string que representam a sequência de números de mensagem e, sinalizador como parâmetros e, define os sinalizadores especificados nas mensagens fornecidas.

Sintaxe

imap_setflag_full($imap_stream, $sequence, $flag [, $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

sequence(Mandatory)

Este é um valor de string que representa a sequência dos números da mensagem. Você também pode especificar um intervalo das mensagens como 4:12.

3

flag(Mandatory)

Este é um valor sting que representa o valor do sinalizador a ser removido ("\\ Visto", "\\ Respondido", "\\ Sinalizado", "\\ Excluído" e "\\ Rascunho").

4

Options(Optional)

Este é um valor inteiro que representa um valor opcional ST_UID, se especificado, você precisa passar UIDs em vez de números de sequência.

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_setflag_full() 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>");
		 		 
         $res = imap_setflag_full($imap, "2,5", "\\Seen \\Flagged");
         if($res){
            print("Messages Were Flagged");
         }else{
            print("Error Occurred");
         }
         //Closing the connection
         imap_close($imap);   		 
      ?>
   </body>
</html>

Resultado

Isso irá gerar a seguinte saída -

Connection established....
Messages Were Flagged

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>");
             
         $list = imap_uid($imap, 2)."".imap_uid($imap, 5);		 
         $res = imap_setflag_full($imap, $list, "\\Seen \\Flagged", ST_UID);
         print("Messages Were Flagged");   
		   
         //Closing the connection
         imap_close($imap);   		 
      
      ?>
   </body>
</html>

Resultado

Isso irá gerar a seguinte saída -

Connection established....
Messages Were Flagged