Açıklama

imap_search(
    IMAP\Connection $imap,
    string $kural,
    int $seçenekler = SE_FREE,
    string $karküm = ""
): array|false

Belirtilen IMAP akımı üzerinde açılmış posta kutusunda bir arama gerçekleştirir.

Örneğin, "annem" tarafından gönderilen yanıtlanmamış tüm iletileri döndürmek için şu kural kullanılır: "UNANSWERED FROM annem". Arama işlemi harf büyüklüğüne duyarsızdır. UW c-client kaynak kodundan okunan kural listesi eksik veya yanlış olabilir (ayrıca bakınız: » RFC1176, "tag SEARCH search_criteria" bölümü).

Bağımsız Değişkenler

imap

IMAP\Connection nesnesi.

kural

Boşluk ayraçlı bir dizge olup aşağıdaki anahtar sözcüklere izin verilir. Çok sözcüklü bağımsız değişkenlerin çift tırnak içine alınması gerekir (örnek: FROM "joey smith").

ALL - Kuralın kalanı ile eşleşen tüm iletiler döndürülür.
ANSWERED - \\ANSWERED (yanıtlandı) imli iletiler döndürülür.
BCC "dizge" - Bcc: başlığında "dizge" bulunan iletiler döndürülür
BEFORE "tarih" - Date: başlığındaki "tarih" tarihinden önceki iletiler döndürülür.
BODY "dizge" - İleti gövdesindeki "dizge" ile eşleşen iletiler döndürülür
CC "dizge" - Cc: başlığında "dizge" bulunan iletiler döndürülür.
DELETED - silinen iletiler döndürülür.
FLAGGED - \\FLAGGED imli (bazan Önemli ve Acil diye de nitelenir) iletiler döndürülür.
FROM "dizge" - From: başlığında "dizge" bulunan iletiler döndürülür.
KEYWORD "dizge" - Bir anahtar sözcük olarak "ileti" içeren iletiler döndürülür.
NEW - Yeni iletiler döndürülür.
OLD - Eski iletiler döndürülür.
ON "tarih" - Date: başlığında "tarih" bulunan iletiler döndürülür.
RECENT - \\RECENT (en yeni) imli iletiler döndürülür.
SEEN - \\SEEN (okundu) imli iletiler döndürülür.
SINCE "tarih" - Date: başlığında "tarih" tarihinden sonraki tarihli iletiler döndürülür.
SUBJECT "dizge" - Subject: başlığında "dizge" bulunan iletiler döndürülür.
TEXT "dizge" - "dizge" metniyle eşleşen iletiler döndürülür.
TO "dizge" - To: başlığında "dizge" bulunan iletiler döndürülür.
UNANSWERED - Yanıtlanmamış iletiler döndürülür.
UNDELETED - Silinmiş iletiler döndürülür.
UNFLAGGED - İmlenmemiş iletiler döndürülür.
UNKEYWORD "dizge" - "dizge" anahtar sözcüğünü içermeyen iletiler döndürülür.
UNSEEN - Henüz okunmamış iletiler döndürülür.

seçenekler

Tek geçerli değer, iletilerin dizi içinde ileti numaralarıyla değil eşsiz kimlikleriyle dönmesini sağlayan SE_UID sabitidir.

karküm

Dizge aramasında kullanılacak MIME karakter kümesi.

Dönen Değerler

İleti numaralarını veya eşsiz kimlikleri içeren bir dizi döner.

kural ile belirtilen arama kuralı anlaşılamazsa veya kurala uyan hiçbir ileti yoksa false döner.

Sürüm Bilgisi

Sürüm:	Açıklama
8.1.0	`imap` bağımsız değişkeni artık IMAP\Connection nesnesi kabul ediyor, evvelce resource türünde geçerli bir `imap` değeri kabul ederdi.

Örnekler

Örnek 1 - imap_search() örneği

<?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);
?>

Yukarıdaki örnek şuna benzer bir çıktı üretir:

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
)

Ayrıca Bakınız

imap_listscan() - Belirtilen metin ile eşleşen posta kutularını listeler