imap_list

(PHP 4, PHP 5)

imap_list — Posta kutularını listeler

Açıklama

array imap_list ( resource $imap_akımı , string $hedef , string $kalıp )

Posta kutusu listesini okur.

Değiştirgeler

imap_akımı

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

hedef

imap_open() işlevinde açıklandığı gibi normal olarak bir sunucu belirtimi olmalıdır.

kalıp

Posta kutusu hiyerarşisi içine aramanın başlayacağı yeri belirtir.

kalıp içinde belirtilebilecek iki özel karakter vardır: Alt dizinlere inilmesini sağlayan '*' ve alt dizinlere inilmemesini sağlayan '%'. kalıp olarak '*' posta kutusu hiyerarşisi içindeki tüm posta kutularının listelenmesini, '%' ise sadece tepe seviyedeki posta kutularının listelenmesini sağlar. kalıp olarak '~/mail/%' belirtilirse alt dizinlere inilmeden sadece ~/mail dizini altındaki posta kutuları listelenir.

Dönen Değerler

Posta kutusu isimlerini içeren bir dizi döner.

Örnekler

Örnek 1 - imap_list() örneği


<?php
$mbox = imap_open("{imap.example.org}", "username", "password", OP_HALFOPEN)
      or die("bağlanılamadı: " . imap_last_error());

$list = imap_list($mbox, "{imap.example.org}", "*");
if (is_array($list)) {
    foreach ($list as $val) {
        echo imap_utf7_decode($val) . "\n";
    }
} else {
    echo "imap_list başarısız oldu: " . imap_last_error() . "\n";
}

imap_close($mbox);
?>

Ayrıca Bakınız

imap_getmailboxes() - Posta kutuları hakkında ayrıntılı bilgi döndürür
imap_lsub() - Üyesi olunan tüm posta kutularını listeler

add a note User Contributed Notes imap_list - [2 notes]

down

c6h1206free at gmail dot com ¶

4 years ago


imap_list returns a simple array of strings that look just like the $ref parameter one needs to specify:



<?php



  $srv = '{imap.example.com}';



  $conn = imap_open($srv, 'me', 'mypass');



  $boxes = imap_list($conn, $srv, '*');



  print_r($boxes);

  imap_close($conn);

?>



Output:



<pre>

Array

(

    [0] => {imap.example.com}Calendar

    [1] => {imap.example.com}Contacts

    [2] => {imap.example.com}Deleted Items

    [3] => {imap.example.com}Drafts

    [4] => {imap.example.com}Journal

    [5] => {imap.example.com}Junk E-mail

    [6] => {imap.example.com}Notes

    [7] => {imap.example.com}Outbox

    [8] => {imap.example.com}RSS Feeds

    [9] => {imap.example.com}Sent Items  

    [10] => {imap.example.com}Tasks

)

</pre>



These directly fill in the $ref argument for every function that takes one.

down

kevin at metalaxe dot com ¶

5 years ago


if there is an error imap_list returns FALSE not an empty array (as expected by docs)

add a note