Manuel PHP
Précédent |  | Suivant

# imap_fetch_overview

(PHP 3 >= 3.0.4, 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

Exemple 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 => $overview) {
echo "#{$overview->msgno} ({$overview->date}) - From: {$overview->from}
{$overview->subject}\n";
}
imap_close($mbox);
?>`

## Voir aussi

imap_fetchheader()

Précédent | Sommaire | Suivant
imap_expunge | Niveau supérieur | imap_fetchbody