PHP - Função imap_clearflag_full ()

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_clearflag_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, remove os sinalizadores especificados das mensagens.

Sintaxe

imap_clearflag_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

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

Resultado

Isso irá gerar a seguinte saída -

Connection established....
Flags Cleared

Exemplo

A seguir está um exemplo do método acima com parâmetro opcional -

<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>");
		 		 
         imap_setflag_full($imap, "2,5", "\\Seen \\Flagged"); 		 
         $list = imap_uid($imap, 2)."".imap_uid($imap, 5);		 
         $res = imap_clearflag_full($imap, $list, "\\Seen \\Flagged", ST_UID);
         if($res){
            print("Flags Cleared");
         } else {
            print("Error Occurred");
         }
         //Closing the connection
         imap_close($imap);  		 
      ?>
   </body>
</html>

Resultado

Isso irá gerar a seguinte saída -

Connection established....
Flags Cleared

↰ Previous page