Manuel PHP
Précédent |  | Suivant

# imap_status

(PHP 3 >= 3.0.4, PHP 4, PHP 5)

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î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 1. 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);
?>`

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