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] => / )