Lista todas as caixas de correio assinadas

# imap_lsub

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

imap_lsub — Lista todas as caixas de correio assinadas

### Descrição

function imap_lsub(IMAP\Connection `$imap`, string `$reference`, string `$pattern`): array|false

Obtém um array de todas as caixas de correio assinadas.

### Parâmetros

`imap`
  Uma instância de IMAP\Connection.
`reference`

  `reference` normalmente deve ser apenas a especificação do servidor conforme descrito em 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 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.

### Valor Retornado

Retorna um array de todas as caixas de correio assinadas, 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

- imap_list() - Lê a lista de caixas de correio
- imap_getmailboxes() - Lê a lista de caixas de correio, retornando informações detalhadas sobre cada uma delas

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open