repo_zf1/documentation/manual/fr/module_specs/Zend_Json-xml2json.xml

<!-- EN-Revision: 12759 -->
<sect1 id="zend.json.xml2json">
    <title>XML to JSON conversion</title>

    <para><classname>Zend_Json</classname> fournit une méthode de convenance pour transformer des données au format XML en un
    format JSON. Ce dispositif est inspiré <ulink
    url="http://www.ibm.com/developerworks/xml/library/x-xml2jsonphp/">d'un article de developerWorks
    d'IBM</ulink>.</para>

    <para><classname>Zend_Json</classname> inclut une fonction statique appelée <classname>Zend_Json::fromXml()</classname>. Cette fonction
    produira du JSON à partir d'une entrée au format XML. Cette fonction prend n'importe quelle chaîne arbitraire XML
    comme paramètre d'entrée. Elle prend également un paramètre booléen facultatif d'entrée pour informer la logique de
    conversion d'ignorer ou non les attributs XML pendant le processus de conversion. Si ce paramètre facultatif
    d'entrée n'est pas donné, alors le comportement par défaut est d'ignorer les attributs XML. Cet appel de fonction
    est réalisé comme ceci :</para>

    <programlisting role="php"><![CDATA[
// la fonction fromXml prend simplement une chaîne
// contenant le XML comme entrée
$jsonContents = Zend_Json::fromXml($xmlStringContents, true);
]]></programlisting>

    <para>La fonction <classname>Zend_Json::fromXml()</classname> fait la conversion du paramètre d'entrée (chaîne au format XML)
    et renvoie le rendu équivalent sous forme de chaîne au format JSON. En cas d'erreur, de format XML ou de logique de
    conversion, cette fonction lèvera une exception. La logique de conversion emploie également des techniques
    récursives à travers l'arbre XML. Il supporte la récursivité jusqu'à 25 niveaux de profondeur. Au delà de cette
    profondeur, elle lèvera une <classname>Zend_Json_Exception</classname>. Il y a plusieurs fichiers XML, avec différents niveaux
    de complexité, fournis dans le répertoire tests de Zend Framework. Ils peuvent être utilisés pour tester la
    fonctionnalité du dispositif xml2json.</para>

    <para>Ce qui suit est un exemple simple qui montre à la fois la chaîne XML fournie et la chaîne JSON retournée en
    résultat de la fonction <classname>Zend_Json::fromXml()</classname>. Cet exemple utilise le paramètre facultatif pour ne pas
    ignorer les attributs XML pendant la conversion. Par conséquent, vous pouvez noter que la chaîne résultante JSON
    inclut une représentation des attributs XML actuels de la chaîne XML fournie.</para>

    <para>Chaîne XML fournie à la fonction <classname>Zend_Json::fromXml()</classname> :</para>

    <programlisting role="php"><![CDATA[
<?xml version="1.0" encoding="UTF-8"?>
<books>
    <book id="1">
        <title>Code Generation in Action</title>
        <author><first>Jack</first><last>Herrington</last></author>
        <publisher>Manning</publisher>
    </book>

    <book id="2">
        <title>PHP Hacks</title>
        <author><first>Jack</first><last>Herrington</last></author>
        <publisher>O'Reilly</publisher>
    </book>

    <book id="3">
        <title>Podcasting Hacks</title>
        <author><first>Jack</first><last>Herrington</last></author>
        <publisher>O'Reilly</publisher>
    </book>
</books>
]]></programlisting>

    <para>Chaîne JSON retournée par la fonction <classname>Zend_Json::fromXml()</classname> :</para>

    <programlisting role="php"><![CDATA[
{
   "books" : {
      "book" : [ {
         "@attributes" : {
            "id" : "1"
         },
         "title" : "Code Generation in Action",
         "author" : {
            "first" : "Jack", "last" : "Herrington"
         },
         "publisher" : "Manning"
      }, {
         "@attributes" : {
            "id" : "2"
         },
         "title" : "PHP Hacks", "author" : {
            "first" : "Jack", "last" : "Herrington"
         },
         "publisher" : "O'Reilly"
      }, {
         "@attributes" : {
            "id" : "3"
         },
         "title" : "Podcasting Hacks", "author" : {
            "first" : "Jack", "last" : "Herrington"
         },
         "publisher" : "O'Reilly"
      }
   ]}
}
]]></programlisting>

    <para>Plus de détails au sujet de ce dispositif xml2json peuvent être trouvés dans la proposition originale
    elle-même. Jetez un oeil à la <ulink
    url="http://framework.zend.com/wiki/display/ZFPROP/Zend_xml2json+-+Senthil+Nathan">proposition
    Zend_xml2json</ulink>.</para>
</sect1>