(PHP 4, PHP 5, PHP 7, PHP 8)
imap_fetch_overview — Lê uma visão geral das informações nos cabeçalhos da mensagem fornecida
Esta função busca cabeçalhos de e-mail para a
sequência fornecida em sequence
e retorna uma visão geral de seus
conteúdos.
imap
Uma instância de IMAP\Connection.
sequence
Uma descrição de sequência de mensagens. Pode-se enumerar mensagens desejadas
com a sintaxe X,Y
ou recuperar todas as mensagens
dentro de um intervalo com a sintaxe X:Y
.
flags
sequence
conterá uma sequência de índices de mensagens
ou UIDs, se este parâmetro for definido como
FT_UID
.
Retorna um array de objetos descrevendo um cabeçalho de mensagem cada. O objeto só definirá uma propriedade se ela existir. As possíveis propriedades são:
subject
- o assunto da mensagem
from
- quem enviou
to
- destinatário
date
- quando foi enviada
message_id
- identificador da mensagem
references
- é uma referência a esta identificação de mensagem
in_reply_to
- é uma resposta a esta identificação de mensagem
size
- tamanho em bytes
uid
- UID que a mensagem tem na caixa de correio
msgno
- número da mensagem na sequência da caixa de correio
recent
- esta mensagem está marcada como recente
flagged
- esta mensagem está marcada
answered
- esta mensagem está marcada como respondida
deleted
- esta mensagem está marcada para exclusão
seen
- esta mensagem está marcada como já lida
draft
- esta mensagem está marcada como um rascunho
udate
- o timestamp UNIX da data/horário de chegada
false
em caso de falha.
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_fetch_overview()
<?php
$mbox = imap_open("{imap.example.org:143}INBOX", "username", "password")
or die("Não foi possível conectar: " . imap_last_error());
$MC = imap_check($mbox);
// Obtém uma visão geral de todas as mensagens na caixa INBOX
$result = imap_fetch_overview($mbox,"1:{$MC->Nmsgs}",0);
foreach ($result as $overview) {
echo "#{$overview->msgno} ({$overview->date}) - De: {$overview->from}
{$overview->subject}\n";
}
imap_close($mbox);
?>