PHP is developed and maintained by a global community of contributors.
The PHP Foundation helps fund this work. If PHP is part of your business or projects, consider sponsoring the Foundation.
(PHP 4, PHP 5, PHP 7, PHP 8)
imap_search — Esta função retorna um array de mensagens que correspondem aos critérios de pesquisa fornecidos
$imap,$criteria,$flags = SE_FREE,$charset = ""Esta função realiza uma pesquisa na caixa de correio atualmente aberta no fluxo IMAP fornecido.
Por exemplo, para corresponder a todas as mensagens não respondidas enviadas pela mãe, você usaria: "UNANSWERED FROM mãe". As pesquisas parecem não diferenciar maiúsculas de maiúsculas. Esta lista de critérios é de uma leitura do código-fonte do c-client UW e pode estar incompleta ou imprecisa (veja também a » RFC1176, seção "tag SEARCH search_criteria").
imapcriteria
Uma string, delimitada por espaços, na qual as seguintes palavras-chave são
permitidas. Quaisquer argumentos com várias palavras (por exemplo,
FROM "joey smith") devem ser citados. Os resultados corresponderão
a todas as entradas do parâmetro criteria.
flags
Os valores válidos para flags são
SE_UID, o que faz com que o array retornado
contenha UIDs em vez de números de sequência de mensagens.
charsetConjunto de caracteres MIME a ser usado ao pesquisar strings.
Retorna um array de números de mensagens ou UIDs.
Retorna false se não entender os critério de pesquisa
informados em criteria ou se nenhuma mensagem foi encontrada.
| 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_search()
<?php
$imap = imap_open('{imap.example.com:993/imap/ssl}INBOX', 'foo@example.com', 'pass123', OP_READONLY);
$some = imap_search($imap, 'SUBJECT "HOWTO be Awesome" SINCE "8 August 2008"', SE_UID);
$msgnos = imap_search($imap, 'ALL');
$uids = imap_search($imap, 'ALL', SE_UID);
print_r($some);
print_r($msgnos);
print_r($uids);
?>O exemplo acima produzirá algo semelhante a:
Array
(
[0] => 4
[1] => 6
[2] => 11
)
Array
(
[0] => 1
[1] => 2
[2] => 3
[3] => 4
[4] => 5
[5] => 6
)
Array
(
[0] => 1
[1] => 4
[2] => 6
[3] => 8
[4] => 11
[5] => 12
)
