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).
Exemple 12.2. 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 :
<?php
$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/.