repo_zf1Php7/documentation/manual/fr/module_specs/Zend_Debug.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 17175 -->
<!-- Reviewed: no -->
<sect1 id="zend.debug.dumping">
    <title>Afficher des informations</title>

    <para>
        La méthode statique <methodname>Zend_Debug::dump()</methodname> affiche et/ou retourne
        les informations concernant une expression. Cette technique simple de débogage est commune,
        parce que facile à utiliser de façon ad hoc et n'exigeant aucune initialisation, aucun
        outils spéciaux, ou environnement de mise au point.
    </para>

    <example id="zend.debug.dumping.example">
        <title>Exemple avec la méthode dump()</title>

        <programlisting language="php"><![CDATA[
Zend_Debug::dump($var, $label=null, $echo=true);
]]></programlisting>
    </example>

    <para>
        L'argument <varname>$var</varname> définit l'expression ou la variable que l'on veut
        examiner avec <methodname>Zend_Debug::dump()</methodname>.
    </para>

    <para>
        L'argument <varname>$label</varname> est un texte arbitraire à placer avant la sortie de
        <methodname>Zend_Debug::dump()</methodname>. Ceci est utile lorsque vous souhaitez afficher à
        l'écran des informations concernant plusieurs variables.
    </para>

    <para>
        Le booléen <varname>$echo</varname> indique s'il faut (ou non) afficher la sortie de
        <methodname>Zend_Debug::dump()</methodname>. Si <constant>TRUE</constant>, la sortie sera affichée.
        Quel que soit l'état de <varname>$echo</varname>, la sortie est toujours retournée.
    </para>

    <para>
        Il peut être utile de savoir que la méthode <methodname>Zend_Debug::dump()</methodname>
        enveloppe la fonction <acronym>PHP</acronym>
        <ulink url="http://php.net/var_dump"><methodname>var_dump()</methodname></ulink>. Si le flux est
        reconnu à destination d'un contenu Web, l'affichage de <methodname>var_dump()</methodname> est échappé
        avec
        <ulink url="http://php.net/htmlspecialchars"><methodname>htmlspecialchars()</methodname></ulink>et est
        enveloppé entre des balises (X)HTML <code>&lt;pre&gt; et &lt;/pre&gt;</code>.
    </para>

    <tip>
        <title>Déboguer avec Zend_Log</title>

        <para>
            Utiliser <methodname>Zend_Debug::dump()</methodname> est ce qui convient le mieux
            pour le débogage durant le développement de l'application. Vous pouvez facilement
            ajouter ou retirer du code que vous souhaitez visualiser.
        </para>

        <para>
            Vous pouvez aussi considérer le composant
            <link linkend="zend.log.overview">Zend_Log</link>si vous souhaitez rendre permanent du
            code de débogage. Par exemple, vous pouvez utiliser le niveau de log <constant>DEBUG</constant>
            et le flux d'écriture Stream du log pour afficher la chaîne retournée par
            <methodname>Zend_Debug::dump()</methodname>.
        </para>
    </tip>
</sect1>