Consommer un flux Atom

La classe Zend_Feed_Atom est utilisée pratiquement de la même manière que Zend_Feed_Rss. Tout comme Zend_Feed_Rss, elle offre aussi un accès aux propriétés du flux et elle permet d'itérer sur les entrées du flux. La différence principale réside dans la structure du protocole Atom lui-même. Atom est le successeur de RSS ; c'est un protocole plus général et il est conçu pour prendre en charge plus facilement les flux qui incluent directement leur contenu, et ce en divisant la balise RSS description en deux éléments : summary (résumé) et content (contenu).

Example #1 Emploi basique de Zend_Feed_Atom

Pour lire un flux Atom et afficher le titre (propriété title) et le résumé (propriété summary) de chaque entrée :

$flux = new Zend_Feed_Atom('http://atom.exemple.com/flux/');
echo 'Le flux contient ' . $flux->count() . ' entrée(s).' . "\n\n";
foreach ($flux as $entree) {
    echo 'Titre : ' . $entree->title() . "\n";
    echo 'Résumé : ' . $entree->summary() . "\n\n";
}

Voici les propriétés liées au flux que vous pourrez trouver dans un flux Atom :

title (titre) : le titre du flux, la même chose que le titre d'un canal RSS
id (identifiant) : avec Atom, chaque flux et entrée possède un identifiant unique
link (lien) : les flux peuvent posséder plusieurs liens, qui se distinguent les uns des autres par un attribut type

Le lien équivalent au lien d'un canal RSS aurait pour type "text/html". Si le lien désigne une version alternative du contenu présent dans le flux, il possédera un attribut rel="alternate"
subtitle (sous-titre) : la description du flux, qui équivaut à la description d'un canal RSS

author->name() : le nom de l'auteur du flux

author->email() : l'adresse e-mail de l'auteur du flux

Les entrées Atom possèdent généralement les propriétés suivantes :

id (identifiant) : l'identifiant unique de l'entrée
title (titre) : le titre de l'entrée, la même chose que le titre d'un élément RSS
link (lien) : un lien vers un autre format ou une vue alternative de l'entrée
summary (résumé) : un résumé du contenu de l'entrée
content (contenu) : le contenu de l'entrée dans son entier ; vous pouvez l'ignorer si le flux ne contient que des résumés
author (auteur) : avec les sous-balises name (nom) et email
published (publié) : la date à laquelle l'entrée a été publiée, au format RFC 3339
updated (publié) : la date à laquelle l'entrée a été mise à jour, au format RFC 3339

Pour plus d'informations sur Atom ainsi qu'un grand nombre de ressources, voyez le site » http://www.atomenabled.org/.