(PHP 4, PHP 5, PHP 7, PHP 8)
imap_listscan — Retorna a lista de caixas de correio que correspondem ao texto fornecido
$imap,$reference,$pattern,$content
Retorna um array contendo os nomes das caixas de correio que têm
content no texto da caixa de correio.
Esta função é semelhante a imap_listmailbox(),
mas também verificará a presença da string
content dentro dos dados da caixa de correio.
imapUma instância de IMAP\Connection.
reference
reference normalmente deve ser apenas a especificação do servidor
conforme descrito em imap_open()
Passar dados não confiáveis para este parâmetro é inseguro, a menos que imap.enable_insecure_rsh esteja desabilitado.
patternEspecifica onde iniciar a pesquisa na hierarquia da caixa de mensagem.
Existem dois caracteres especiais que podem
ser passados como parte do parâmetro pattern:
'*' e '%'.
'*' significa retornar todas as caixas de mensagem. Se
pattern for passado como '*', será retornada
uma lista de toda a hierarquia da caixa de mensagem.
'%'
significa retornar apenas o nível atual.
Passar '%' como o parâmetro pattern
retornará apenas as caixas de mensagem do nível
mais alto; Passar '~/mail/%' em UW_IMAPD retornará todas as caixas de mensagem no diretório ~/mail, mas não retornará nenhuma nas subpastas deste diretório.
contentA string pesquisada
Retorna um array contendo os nomes das caixas de correio que têm
content no texto da caixa de correio, ou 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.
|