Lire un flux RSS se résume à instancier un objet Zend_Feed_Rss en passant l'URL du flux :

<?php

$canal = new Zend_Feed_Rss('http://rss.exemple.com/nomDuCanal');

?>

Si une erreur a lieu lors de l'obtention du flux, une Zend_Feed_Exception sera déclenchée.

Une fois que vous disposez d'un objet "flux RSS", vous pouvez accéder aux propriétés RSS standard du canal, et ce directement à partir de l'objet :

<?php

echo $canal->title();

?>

Notez la syntaxe utilisée : un appel de fonction. Zend_Feed utilise une convention selon laquelle les propriétés sont traitées comme des objets XML si elles sont demandées au moyen de la syntaxe $obj->propriété et comme des chaînes si elles sont demandées au moyen de la syntaxe $obj->propriété(). Ceci permet d'accéder à la totalité du contenu textuel d'un nœud particulier tout comme à l'ensemble des enfants de ce nœud.

Si les propriétés du canal possèdent des attributs, ils sont accessibles à l'aide de l'indiçage PHP :

<?php

echo $canal->category['domain'];

?>

Comme les attributs XML ne peuvent avoir des enfants, la syntaxe $obj->propriété['attribut']() n'est pas nécessaire pour accéder aux valeurs des attributs.

La plupart du temps vous voudrez itérer sur le flux et réaliser quelque chose avec ses entrées. Zend_Feed_Abstract implémente l'interface iterator de PHP, ce qui résume au code suivant l'affichage des titres de tous les articles du canal :

<?php

foreach ($canal as $elem) {
    echo $elem->title() . "\n";
}

?>

Si vous n'êtes pas un familier de RSS, voici les éléments standard associés au canal RSS et à ses éléments pris séparément (les entrées).

Les éléments requis pour les canaux sont :

Les éléments optionnels pour les canaux sont :

Les éléments RSS <item> n'ont pas d'éléments requis particulier. Cependant soit title soit description doivent être présents.

Les éléments communs sont :

Dans votre code vous pouvez toujours tester si un élément est non-vide au moyen du test suivant :

<?php

if ($elemt->nomPropriete()) {
    // ... traitement
}

?>

Si vous utilisez à la place de la condition $elem->nomPropriete, vous obtiendrez toujours un objet qui, même vide, sera évalué comme TRUE, donc le test échouera.

Pour plus d'informations, la spécification RSS 2.0 officielle est disponible à l'adresse : http://blogs.law.harvard.edu/tech/rss