PHP - Função imap_ping ()

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_ping() A função aceita um valor de recurso que representa um fluxo IMAP como parâmetro e verifica se o fluxo fornecido ainda está ativo.

Sintaxe

imap_ping($imap_stream);

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.

Valores Retornados

Esta função retorna um valor booleano se o fluxo fornecido ainda estiver ativo e FALSE se não estiver.

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_ping() 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>");
		   
         //list of mailboxes
         $res = imap_ping($imap);
	      
         if($res){
            print("IMAP stream is alive");		 
         } else {
            print("IMAP stream is not alive");		 
         }
         //Closing the connection
         imap_close($imap);   
      ?>
   </body>
</html>

Resultado

Isso irá gerar a seguinte saída -

Connection established....
IMAP stream is alive

Exemplo

A seguir está outro exemplo desta função -

<html>
   <body>
      <?php
         $url = "{imap.gmail.com:993/imap/ssl/novalidate-cert}INBOX";
         $id = "[email protected]";
         $pwd = "cohondob_123";
         $mailbox = imap_open($url, $id, $pwd);
         print("Connection established....");

         if (imap_ping($mailbox)) {
            //Retrieving the contents of mail boxes
            $list = imap_getmailboxes($mailbox, $url, "*");
            if (is_array($list)) {
              foreach ($list as $key => $val) {
                  print_r($val);
                  print("<br>");
               }
            }else{  }
         }
      ?>
   </body>
</html>

Resultado

Isso gera a seguinte saída -

Connection established....stdClass Object ( [name] => 
{imap.gmail.com:993/imap/ssl/novalidate-cert}INBOX [attributes] => 64 
[delimiter] => / )
stdClass Object ( [name] => 
{imap.gmail.com:993/imap/ssl/novalidate-cert}INBOX.changed_mail1 [attributes] =
> 64 [delimiter] => / )
stdClass Object ( [name] => 
{imap.gmail.com:993/imap/ssl/novalidate-cert}INBOX.changed_mail2 [attributes] =
> 64 [delimiter] => / )