(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)
imap_get_quota — Recupera as configurações de nível de cota e estatísticas de uso por caixa de correio
Recupera as configurações de nível de cota e estatísticas de uso por caixa de correio.
Para uma versão desta função para usuários não administradores, consulte a função imap_get_quotaroot() do PHP.
imap
Uma instância de IMAP\Connection.
quota_root
quota_root
normalmente deve estar no formato de
user.name
onde name é a caixa de correio sobre a qual se deseja
recuperar informações.
Retorna um array com valores inteiros de limite ("limit") e uso ("usage") para a caixa de correio
fornecida. O valor de limite representa a quantidade total de espaço
permitida para esta caixa de correio. O valor de uso representa o nível atual de capacidade da caixa de correio.
Retornará false
em caso de falha.
A partir do PHP 4.3, a função reflete mais adequadamente a funcionalidade conforme ditado pela » RFC2087. O valor de retorno do array foi alterado para suportar um número ilimitado de recursos retornados (por exemplo, mensagens ou subpastas) com cada recurso nomeado recebendo uma chave de array individual. Cada valor de chave contém então um outro array com os valores de uso e limite dentro dele.
Por razões de compatibilidade com versões anteriores, os métodos de acesso originais ainda estão disponíveis para uso, embora seja sugerido atualizá-los.
Versão | Descrição |
---|---|
8.1.0 |
O parâmetro imap agora espera uma instância de IMAP\Connection;
anteriormente, um resource imap válido era esperado.
|
Exemplo #1 Exemplo de imap_get_quota()
<?php
$mbox = imap_open("{imap.example.org}", "mailadmin", "password", OP_HALFOPEN)
or die("Não foi possível conectar: " . imap_last_error());
$quota_value = imap_get_quota($mbox, "user.kalowsky");
if (is_array($quota_value)) {
echo "Nível de uso é: " . $quota_value['usage'];
echo "Nível de limite é: " . $quota_value['limit'];
}
imap_close($mbox);
?>
Exemplo #2 Exemplo de imap_get_quota() para versão 4.3 ou superior
<?php
$mbox = imap_open("{imap.example.org}", "mailadmin", "password", OP_HALFOPEN)
or die("Não foi possível conectar: " . imap_last_error());
$quota_values = imap_get_quota($mbox, "user.kalowsky");
if (is_array($quota_values)) {
$storage = $quota_values['STORAGE'];
echo "Nível de uso STORAGE é: " . $storage['usage'];
echo "Nível de limite STORAGE é: " . $storage['limit'];
$message = $quota_values['MESSAGE'];
echo "Nível de uso MESSAGE é: " . $message['usage'];
echo "Nível de limite MESSAGE é: " . $message['limit'];
/* ... */
}
imap_close($mbox);
?>
Esta função está disponível atualmente apenas para usuários da biblioteca c-client2000 ou superior.
O imap
fornecido deve ser aberto como administrador de e-mail,
caso contrário, esta função falhará.