imap_sort
<<<		 imap_status imap_subscribe
>>>
6.15 IMAP
6 Référence des fonctions
 Manuel PHP
. Introduction
. Pré-requis
. Installation
. Configuration à l'exécution
. Types de ressources
. Constantes pré-définies
. Voir aussi
. imap_8bit
. imap_alerts
. imap_append
. imap_base64
. imap_binary
. imap_body
. imap_bodystruct
. imap_check
. imap_clearflag_full
. imap_close
. imap_createmailbox
. imap_delete
. imap_deletemailbox
. imap_errors
. imap_expunge
. imap_fetch_overview
. imap_fetchbody
. imap_fetchheader
. imap_fetchstructure
. imap_get_quota
. imap_get_quotaroot
. imap_getacl
. imap_getmailboxes
. imap_getsubscribed
. imap_header
. imap_headerinfo
. imap_headers
. imap_last_error
. imap_list
. imap_listmailbox
. imap_listscan
. imap_listsubscribed
. imap_lsub
. imap_mail_compose
. imap_mail_copy
. imap_mail_move
. imap_mail
. imap_mailboxmsginfo
. imap_mime_header_decode
. imap_msgno
. imap_num_msg
. imap_num_recent
. imap_open
. imap_ping
. imap_qprint
. imap_renamemailbox
. imap_reopen
. imap_rfc822_parse_adrlist
. imap_rfc822_parse_headers
. imap_rfc822_write_address
. imap_scanmailbox
. imap_search
. imap_set_quota
. imap_setacl
. imap_setflag_full
. imap_sort
->imap_status
. imap_subscribe
. imap_thread
. imap_timeout
. imap_uid
. imap_undelete
. imap_unsubscribe
. imap_utf7_decode
. imap_utf7_encode
. imap_utf8

6.15.64 imap_status() Retourne les informations de statut sur une boîte aux lettres autres que la boîte courante

[ Exemples avec imap_status ]   PHP 3 >= 3.0.4, PHP 4, PHP 5

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îte aux lettres.
  • SA_RECENT - met la valeur de status->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 toutes les valeurs précédentes.

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

Exemple avec 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) {
    echo "Messages:    " . $status->messages    . "<br />\n";
    echo "Récents:     " . $status->recent      . "<br />\n";
    echo "Non lus:     " . $status->unseen      . "<br />\n";
    echo "UIDnext:     " . $status->uidnext     . "<br />\n";
    echo "UIDvalidité: " . $status->uidvalidity . "<br />\n";
} else {
    echo "imap_status a échoué : " . imap_last_error() . "\n";
}

imap_close($mbox);
?>

<< imap_status >>
imap_sort IMAP imap_subscribe