imap_fetch_overview
(PHP 4, PHP 5)
imap_fetch_overview — Lit le sommaire des en-têtes de messages
Description
array imap_fetch_overview
( resource $imap_stream
, string $sequence
[, int $options
] )
imap_fetch_overview() lit les en-têtes des courriers électroniques de la séquence sequence et retourne un sommaire de leur contenu.
Liste de paramètres
- imap_stream
-
Un flux IMPA retourné par la fonction imap_open().
- sequence
-
Une description de la séquence du message. Vous pouvez énumérer les messages désirés avec la synthaxe X,Y, ou récupérer tous les messages d'un intervalle, avec la synthaxe X:Y
- options
-
sequence va contenir une séquence d'indice de message ou d'UIDs, si flags contient FT_UID.
Valeurs de retour
Retourne un tableau d'objets décrivant l'en-tête de chaque message. L'objet ne définira une propriété que si elle existe. Les propriétés possibles sont :
- subject - Le sujet du message
- from - Expéditeur
- to - Destinataire
- date - Date d'expédition
- message_id - Identification du message
- references - est une référence sur l'id de ce message
- in_reply_to - est une réponse à cet identifiant de message
- size - taille en octets
- uid - UID du message dans la boîte aux lettres
- msgno - numéro de séquence du message dans la boîte
- recent - Ce message est récent
- flagged - Ce message est marqué
- answered - Ce message a donné lieu à une réponse
- deleted - Ce message est marqué pour l'effacement
- seen - Ce message est déjà lu
- draft - Ce message est un brouillon
Exemples
Example#1 Exemple avec imap_fetch_overview()
<?php
$mbox = imap_open("{imap.example.org:143}INBOX", "username", "password")
or die("Connexion impossible : " . imap_last_error());
$MC = imap_check($mbox);
// Récupère le sommaire pour tous les messages contenus dans INBOX
$result = imap_fetch_overview($mbox,"1:{$MC->Nmsgs}",0);
foreach ($result as $overview) {
echo "#{$overview->msgno} ({$overview->date}) - From: {$overview->from}
{$overview->subject}\n";
}
imap_close($mbox);
?>