imap_search

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

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

    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.0imap 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
    To Top