array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.imap-fetchheader.php', 1 => 'imap_fetchheader', 2 => 'Retorna o cabeçalho de uma mensagem', ), 'up' => array ( 0 => 'ref.imap.php', 1 => 'Funções de IMAP', ), 'prev' => array ( 0 => 'function.imap-fetchbody.php', 1 => 'imap_fetchbody', ), 'next' => array ( 0 => 'function.imap-fetchmime.php', 1 => 'imap_fetchmime', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/imap/functions/imap-fetchheader.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

imap_fetchheader

(PHP 4, PHP 5, PHP 7, PHP 8)

imap_fetchheader — Retorna o cabeçalho de uma mensagem

Descrição

imap_fetchheader(IMAP\Connection $imap, int $message_num, int $flags = 0): string|false

Esta função causa uma busca do cabeçalho completo e não filtrado no formato » RFC2822 da mensagem especificada.

Parâmetros

imap

Uma instância de IMAP\Connection.

message_num

O número da mensagem

flags

Os possíveis valores para flags são:

  • FT_UID - O argumento message_num é um UID
  • FT_INTERNAL - A string de retorno está no formato "interno", sem nenhuma tentativa de canonizar para novas linhas CRLF
  • FT_PREFETCHTEXT - O RFC822.TEXT deve ser pré-buscado ao mesmo tempo. Isso evita um RTT extra em uma conexão IMAP se um texto de mensagem completo for desejado (por exemplo, em uma operação "salvar em arquivo local")

Valor Retornado

Retorna o cabeçalho da mensagem especificada como uma sequência de texto, ou false em caso de falha.

Registro de Alterações

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.

Veja Também