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 390. 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 attributtype
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 attributrel="alternate"
-
subtitle
(sous-titre) : la description du flux, qui équivaut à la description d'un canal RSSauthor->name()
: le nom de l'auteur du fluxauthor->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-balisesname
(nom) etemail
-
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/.