Belirtilen kurala uyan iletileri bir dizi içinde döndürür

Açıklama

imap_search ( resource $imap_akımı , string $kural [, int $seçenekler = SE_FREE [, string $karküm = NIL ]] ) : array

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: » RFC2060, bölüm 6.4.4).

Değiştirgeler

imap_akımı

imap_open() işlevinden dönen bir IMAP akımı.

kural

Boşluk ayraçlı bir dizge olup aşağıdaki anahtar sözcüklere izin verilir. Çok sözcüklü değiştirgelerin ç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

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
4.3.3	`karküm` değiştirgesi eklendi.

Ayrıca Bakınız

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