repo_zf1/documentation/manual/es/module_specs/Zend_Debug.xml

<!-- versión 11089 -->
<sect1 id="zend.debug.dumping">

    <title>Mostrar información de variables(Dumping Variables)</title>

    <para>
        El método estático <code>Zend_Debug::dump()</code> imprime o devuelve
        información sobre una expresión. Esta sencilla técnica de depuración es
        común, porque es fácil de utilizar en caliente y no requiere
        inicialización, herramientas especiales, o la depuración del entorno.
    </para>

    <example id="zend.debug.dumping.example">
        <title>Ejemplo del método dump()</title>
        <programlisting role="php"><![CDATA[

Zend_Debug::dump($var, $label=null, $echo=true);
]]>
        </programlisting>
    </example>

    <para>
        El argumento <code>$var</code> especifica la expresión o variable sobre
        la cual el método <code>Zend_Debug::dump()</code> generará información.
    </para>

    <para>
        El argumento boleano <code>$echo</code> especifica si la salida de
        <code>Zend_Debug::dump()</code> es o no mostrada. Si es
        <code>verdadera</code>, la salida es mostrada. A pesar del valor del
        argumento <code>$echo</code>, el retorno de este método contiene la
        salida.
    </para>

    <para>
        Puede ser útil comprender que el método <code>Zend_Debug::dump()</code>
        envuelve la función de PHP
        <ulink url="http://php.net/var_dump"><code>var_dump()</code></ulink>.
        Si el flujo de salida es detectado como una presentación de la web, la
        salida de <code>var_dump()</code> es escapada usando
        <ulink url="http://php.net/htmlspecialchars"><code>htmlspecialchars()</code></ulink>
        y envuelta con el tag (X)HTML <code>pre</code>.
    </para>

    <tip>
        <title>Depurando con Zend_Log</title>
        <para>
            Usar <code>Zend_Debug::dump()</code> es lo mejor para la depuración
            en caliente durante el desarrollo de software. Puede añadir el código para
            volcar una variable y después quitar el código fácilmente.
        </para>
        <para>
            También considere el componente <link linkend="zend.log.overview">
            Zend_Log</link> escribiendo el código de depuración más
            permanente. Por ejemplo, puede utilizar el nivel de log de
            <code>DEPURACIÓN</code> y el Stream log writer, para mostrar la
            cadena de salida de <code>Zend_Debug::dump()</code>.
        </para>
    </tip>

</sect1>
<!--
    vim:se ts=4 sw=4 et:
-->