documentation/manual/es/module_specs/Zend_Debug.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2     <!-- EN-Revision: 20766 -->
   3     <!-- Reviewed: no -->
   4 <sect1 id="zend.debug.dumping">
   5
   6     <title>Mostrar información de variables(Dumping Variables)</title>
   7
   8     <para>
   9         El método estático
  10         <methodname>Zend_Debug::dump()</methodname>
  11         imprime o devuelve
  12         información sobre una expresión. Esta sencilla técnica de depuración es
  13         común, porque es fácil de utilizar en caliente y no requiere
  14         inicialización, herramientas
  15         especiales, o la depuración del entorno.
  16     </para>
  17
  18     <example id="zend.debug.dumping.example">
  19         <title>Ejemplo del método dump()</title>
  20         <programlisting language="php"><![CDATA[
  21 Zend_Debug::dump($var, $label=null, $echo=true);
  22 ]]></programlisting>
  23     </example>
  24
  25     <para>
  26         El argumento
  27         <varname>$var</varname>
  28         especifica la expresión o variable sobre
  29         la cual el método
  30         <methodname>Zend_Debug::dump()</methodname>
  31         generará información.
  32     </para>
  33
  34     <para>
  35         The
  36         <varname>$label</varname>
  37         argument is a string to be prepended to the
  38         output of
  39         <methodname>Zend_Debug::dump()</methodname>
  40         . It may be useful, for
  41         example, to use labels if you are dumping information about multiple
  42         variables on a given screen.
  43     </para>
  44
  45     <para>
  46         El argumento boleano
  47         <varname>$echo</varname>
  48         especifica si la salida de
  49         <methodname>Zend_Debug::dump()</methodname>
  50         es o no mostrada. Si es
  51         <constant>TRUE</constant>
  52         , la salida es mostrada. A pesar del valor del
  53         argumento
  54         <varname>$echo</varname>
  55         , el retorno de este método contiene la
  56         salida.
  57     </para>
  58
  59     <para>
  60         Puede ser útil comprender que el método
  61         <methodname>Zend_Debug::dump()</methodname>
  62         envuelve la función de
  63         <acronym>PHP</acronym>
  64         <ulink url="http://php.net/var_dump">
  65             <methodname>var_dump()</methodname>
  66         </ulink>
  67         .
  68         Si el flujo de salida es detectado como una presentación de la web, la
  69         salida de
  70         <methodname>var_dump()</methodname>
  71         es escapada usando
  72         <ulink url="http://php.net/htmlspecialchars">
  73             <methodname>htmlspecialchars()</methodname>
  74         </ulink>
  75         y envuelta con el tag (X)HTML
  76         <command>&lt;pre&gt;</command>
  77         .
  78     </para>
  79
  80     <tip>
  81         <title>Depurando con Zend_Log</title>
  82         <para>
  83             Usar
  84             <methodname>Zend_Debug::dump()</methodname>
  85             es lo mejor para la depuración
  86             en caliente durante el desarrollo de software. Puede
  87             añadir el código para
  88             volcar una variable y después quitar el código fácilmente.
  89         </para>
  90         <para>
  91             También considere el componente
  92             <link linkend="zend.log.overview">
  93                 Zend_Log</link>
  94             component when writing more permanent debugging code. For example,
  95             you can use the
  96             <constant>DEBUG</constant>
  97             log level and the
  98             <link linkend="zend.log.writers.stream">stream log writer</link>
  99             to
 100             output the string returned by
 101             <methodname>Zend_Debug::dump()</methodname>
 102             .
 103         </para>
 104     </tip>
 105
 106 </sect1>
 107     <!--
 108     vim:se ts=4 sw=4 et:
 109 -->