Manuel PHP
Précédent |  | Suivant

# imap_status

(3.0.4 - 3.0.18 only, PHP 4 >= 4.0.0)

imap_status -- Retourne les informations de statut sur une boîte aux lettres autres que la boîte courante.

## Description

``object imap_status` (resource imap_stream, string mailbox, int options)`

imap_status() retourne un objet contenant les informations de statut. Les options valables sont :

- SA_MESSAGES - met la valeur de status->messages au nombre de messages dans la boîtes aux lettres.

- SA_RECENT - met la valeur destatus->recent au nombre de messages récents dans la boîte aux lettres.

- SA_UNSEEN - met la valeur de status->unseen au nombre de messages non lus dans la boîte aux lettres.

- SA_UIDNEXT - met la valeur de status->uidnext à la prochaine valeur d'uid qui sera utilisée.

- SA_UIDVALIDITY - met la valeur de status->uidvalidity à une constante, qui change lorsque l'uid de la boîte aux lettres n'est plus valide.

- SA_ALL - fixe les valeurs de de toutes les précédents.

status->flags est aussi fixé : c'est un masque de bit qui peut contenir tous les flags ci-dessus.

Exemple 1. Exemple imap_status()
    <?php
      $mbox = imap_open("{your.imap.host}","utilisateur","mot_de_passe",OP_HALFOPEN)
         or die("can't connect: ".imap_last_error());
      $status = imap_status($mbox,"{your.imap.host}INBOX",SA_ALL);
      if($status) {
        print("Messages:   ". $status->messages   )."<br>\n";
        print("Récents:     ". $status->recent     )."<br>\n";
        print("Non lus:     ". $status->unseen     )."<br>\n";
        print("UIDnext:    ". $status->uidnext    )."<br>\n";
        print("UIDvalidité:". $status->uidvalidity)."<br>\n";
      } else {
        print "imap_status a échoué : ".imap_last_error()."\n";
      }
      imap_close($mbox);
    ?>

Précédent | Sommaire | Suivant
imap_sort | Niveau supérieur | imap_subscribe