(PHP 4, PHP 5, PHP 7, PHP 8)
imap_search — Belirtilen kurala uyan iletileri bir dizi içinde döndürür
$imap,$kural,$seçenekler = SE_FREE,$karküm = ""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ü).
imapIMAP\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ümDizge aramasında kullanılacak MIME karakter kümesi.
İ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: | 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.
|
Ö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
)