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

<?xml version="1.0" encoding="UTF-8"?>
    <!-- EN-Revision: 24249 -->
    <!-- Reviewed: no -->
<sect1 id="zend.debug.dumping">

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

    <para>
        El método estático
        <methodname>Zend_Debug::dump()</methodname>
        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 language="php"><![CDATA[
Zend_Debug::dump($var, $label=null, $echo=true);
]]></programlisting>
    </example>

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

    <para>
        The
        <varname>$label</varname>
        argument is a string to be prepended to the
        output of
        <methodname>Zend_Debug::dump()</methodname>
        . It may be useful, for
        example, to use labels if you are dumping information about multiple
        variables on a given screen.
    </para>

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

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

    <tip>
        <title>Depurando con Zend_Log</title>
        <para>
            Usar
            <methodname>Zend_Debug::dump()</methodname>
            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>
            component when writing more permanent debugging code. For example,
            you can use the
            <constant>DEBUG</constant>
            log level and the
            <link linkend="zend.log.writers.stream">stream log writer</link>
            to
            output the string returned by
            <methodname>Zend_Debug::dump()</methodname>
            .
        </para>
    </tip>

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