repo_zf1/documentation/manual/fr/module_specs/Zend_Feed-ConsumingAtom.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 24249 -->
<!-- Reviewed: no -->
<sect1 id="zend.feed.consuming-atom">
    <title>Consommer un flux Atom</title>

    <para>
        La classe <classname>Zend_Feed_Atom</classname> est utilisée pratiquement de la même
        manière que <classname>Zend_Feed_Rss</classname>. Tout comme
        <classname>Zend_Feed_Rss</classname>, 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 <acronym>RSS</acronym>&#160;; 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 <acronym>RSS</acronym> <code>description</code>
        en deux éléments&#160;: <code>summary</code> (résumé) et <code>content</code> (contenu).
    </para>

    <example id="zend.feed.consuming-atom.example.usage">
        <title>Emploi basique de Zend_Feed_Atom</title>

        <para>
            Pour lire un flux Atom et afficher le titre (propriété <code>title</code>) et le
            résumé (propriété <code>summary</code>) de chaque entrée&#160;:
        </para>

        <programlisting language="php"><![CDATA[
$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";
}
]]></programlisting>
    </example>

    <para>
        Voici les propriétés liées au flux que vous pourrez trouver dans un flux Atom&#160;:
    </para>

    <para>
        <itemizedlist>
            <listitem>
                <para>
                    <code>title</code> (titre)&#160;: le titre du flux, la même chose que le titre
                    d'un canal <acronym>RSS</acronym>
                </para>
            </listitem>

            <listitem>
                <para>
                    <code>id</code> (identifiant)&#160;: avec Atom, chaque flux et entrée possède
                    un identifiant unique
                </para>
            </listitem>

            <listitem>
                <para>
                    <code>link</code> (lien)&#160;: les flux peuvent posséder plusieurs liens, qui
                    se distinguent les uns des autres par un attribut <code>type</code>
                </para>

                <para>
                    Le lien équivalent au lien d'un canal <acronym>RSS</acronym> aurait pour type
                    <code>"text/html"</code>. Si le lien désigne une version alternative du contenu
                    présent dans le flux, il possédera un attribut
                    <code>rel="alternate"</code>
                </para>
            </listitem>

            <listitem>
                <para>
                    <code>subtitle</code> (sous-titre)&#160;: la description du flux, qui équivaut
                    à la description d'un canal <acronym>RSS</acronym>
                </para>

                <para><code>author-&gt;name()</code>&#160;: le nom de l'auteur du flux</para>

                <para>
                    <code>author-&gt;email()</code>&#160;: l'adresse e-mail de l'auteur du
                    flux
                </para>
            </listitem>
        </itemizedlist>
    </para>

    <para>Les entrées Atom possèdent généralement les propriétés suivantes&#160;:</para>

    <para>
        <itemizedlist>
            <listitem>
                <para>
                    <code>id</code> (identifiant)&#160;: l'identifiant unique de l'entrée
                </para>
            </listitem>

            <listitem>
                <para>
                    <code>title</code> (titre)&#160;: le titre de l'entrée, la même chose que le
                    titre d'un élément <acronym>RSS</acronym>
                </para>
            </listitem>

            <listitem>
                <para>
                    <code>link</code> (lien)&#160;: un lien vers un autre format ou une vue
                    alternative de l'entrée
                </para>
            </listitem>

            <listitem>
                <para><code>summary</code> (résumé)&#160;: un résumé du contenu de l'entrée</para>
            </listitem>

            <listitem>
                <para>
                    <code>content</code> (contenu)&#160;: le contenu de l'entrée dans son
                    entier&#160;; vous pouvez l'ignorer si le flux ne contient que des résumés
                </para>
            </listitem>

            <listitem>
                <para>
                    <code>author</code> (auteur)&#160;: avec les sous-balises <code>name</code>
                    (nom) et <code>email</code>
                </para>
            </listitem>

            <listitem>
                <para>
                    <code>published</code> (publié)&#160;: la date à laquelle l'entrée a été
                    publiée, au format <acronym>RFC</acronym> 3339
                </para>
            </listitem>

            <listitem>
                <para>
                    <code>updated</code> (publié)&#160;: la date à laquelle l'entrée a été mise à
                    jour, au format <acronym>RFC</acronym> 3339
                </para>
            </listitem>
        </itemizedlist>
    </para>

    <para>
        Pour plus d'informations sur Atom ainsi qu'un grand nombre de ressources, voyez le
        site <ulink url="http://www.atomenabled.org/">http://www.atomenabled.org/</ulink>.
    </para>
</sect1>