PHP - Função imap_status ()
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_status() A função aceita um valor de recurso que representa um fluxo IMAP, um valor de string que representa o url / nome da caixa de correio e um inteiro que representa o valor opcional como um parâmetro, recupera e retorna o status da caixa de correio fornecida.
Sintaxe
imap_status($imap_stream, $mailbox, $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 |
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 |
options (Mandatory) Este é um valor inteiro que representa o parâmetro opcional, que pode ser um dos seguintes:
|
Valores Retornados
Esta função retorna um objeto que contém as informações de status da caixa de correio fornecida.
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_status() 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>");
//Status info of the mailbox
$info = imap_status($imap, $url, SA_ALL);
print_r($info);
//Closing the connection
imap_close($imap);
?>
</body>
</html>
Resultado
Isso irá gerar a seguinte saída -
Connection established....
stdClass Object (
[flags] => 31 [messages] => 12 [recent] => 0
[unseen] => 2 [uidnext] => 61 [uidvalidity] => 1
)
Exemplo
A seguir está outro exemplo da função acima -
<html>
<body>
<?php
//Establishing connection
$url = "{imap.gmail.com:993/imap/ssl/novalidate-cert}INBOX";
$id = "[email protected]il.com";
$pwd = "cohondob_123";
$imap = imap_open($url, $id, $pwd);
print("Connection established...."."<br>");
//Status info of the mailbox
print_r(imap_status($imap, $url, SA_MESSAGES));
print("<br>");
print_r(imap_status($imap, $url, SA_RECENT));
print("<br>");
print_r(imap_status($imap, $url, SA_UNSEEN));
print("<br>");
print_r(imap_status($imap, $url, SA_UIDNEXT));
print("<br>");
print_r(imap_status($imap, $url, SA_UIDVALIDITY));
print("<br>");
print_r(imap_status($imap, $url, SA_ALL));
//Closing the connection
imap_close($imap);
?>
</body>
</html>
Resultado
Isso irá gerar a seguinte saída -
Connection established....
stdClass Object ( [flags] => 1 [messages] => 12 )
stdClass Object ( [flags] => 2 [recent] => 0 )
stdClass Object ( [flags] => 4 [unseen] => 2 )
stdClass Object ( [flags] => 8 [uidnext] => 61 )
stdClass Object ( [flags] => 16 [uidvalidity] => 1 )
stdClass Object ( [flags] => 31 [messages] => 12 [recent] => 0 [unseen] => 2 [uidnext] => 61 [uidvalidity] => 1 )