imap_listscan

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

imap_listscanReturns the list of mailboxes that matches the given text

Descrição

imap_listscan(
    IMAP\Connection $imap,
    string $reference,
    string $pattern,
    string $content
): array|false

Returns an array containing the names of the mailboxes that have content in the text of the mailbox.

This function is similar to imap_listmailbox(), but it will additionally check for the presence of the string content inside the mailbox data.

Parâmetros

imap

Uma instância de IMAP\Connection.

reference

reference should normally be just the server specification as described in imap_open()

Aviso

Passar dados não confiáveis para este parâmetro é inseguro, a menos que imap.enable_insecure_rsh esteja desabilitado.

pattern

Especifica onde começar a pesquisar na hierarquia da caixa de entrada.

Existem dois caracteres especiais que podem ser passados como parte do parâmetro pattern: '*' e '%'. '*' significa retornar todas as caixas de entrada. Se pattern for passado como '*', será retornada uma lista de toda a hierarquia da caixa de entrada. '%' significa retornar apenas o nível atual. Passar '%' como o parâmetro pattern retornará apenas as caixas de entrada do nível mais alto; Passar '~/mail/%' em UW_IMAPD retornará todas as caixas de entrada no diretório ~/mail, mas não retornará nenhuma nas subpastas deste diretório.

content

The searched string

Valor Retornado

Returns an array containing the names of the mailboxes that have content in the text of the mailbox, ou false em caso de falha.

Changelog

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

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top