documentation/manual/pl/module_specs/Zend_Debug.xml

   1 <sect1 id="zend.debug.dumping">
   2
   3     <title>Wyświetlanie informacji o zmiennych</title>
   4
   5     <para>
   6         Statyczna metoda <code>Zend_Debug::dump()</code> wyświetla lub zwraca
   7         informacje o wyrażeniu. Ta prosta technika usuwania błędów jest często
   8         używana, ponieważ jest łatwa w użyciu, nie wymaga inicjowania, użycia
   9         specjalnych narzędzi czy środowiska testowego.
  10     </para>
  11
  12     <example id="zend.debug.dumping.example">
  13         <title>Przykład użycia metody dump()</title>
  14         <programlisting role="php"><![CDATA[
  15 Zend_Debug::dump($var, $label=null, $echo=true);
  16 ]]>
  17         </programlisting>
  18     </example>
  19
  20     <para>
  21         Argument <code>$var</code> określa wyrażenie lub zmienną, na temat
  22         której metoda <code>Zend_Debug::dump()</code> ma wyświetlić informacje.
  23     </para>
  24
  25     <para>
  26         Argument <code>$label</code> jest łańcuchem znaków, który zostanie
  27         dołączony na początku wyniku użycia metody <code>Zend_Debug::dump()</code>.
  28         Użycie takich etykiet może być użyteczne na przykład wtedy, gdy
  29         wyświetlasz informacje o wielu zmiennych na jednym ekranie.
  30     </para>
  31
  32     <para>
  33         Wartość logiczna argumentu <code>$echo</code> określa czy wynik użycia
  34         metody <code>Zend_Debug::dump()</code> ma być wyświetlony, czy nie.
  35         Jeśli ma wartość <code>true</code>, wynik jest wyświetlony. Niezależnie
  36         od wartości tego argumentu, metoda na koniec zwraca wynik.
  37     </para>
  38
  39     <para>
  40         Użyteczna może być informacja o tym, że metoda
  41         <code>Zend_Debug::dump()</code> używa funkcji PHP
  42         <ulink url="http://php.net/var_dump"><code>var_dump()</code></ulink>.
  43         Jeśli dane wyjsciowe mają być wyświetlone w przeglądarce, to w wyniku
  44         zwróconym przez wywołanie metody <code>var_dump()</code> znaki
  45         specjalne cytowane są za pomocą funkcji
  46         <ulink url="http://php.net/htmlspecialchars"><code>htmlspecialchars()</code></ulink>,
  47         a cały wynik zostaje objęty znacznikami (X)HTML <code>&lt;pre&gt;</code>.
  48     </para>
  49
  50     <tip>
  51         <title>Usuwanie błędów za pomocą Zend_Log</title>
  52         <para>
  53             Użycie metody <code>Zend_Debug::dump()</code> jest najlepsze do
  54             doraźnego usuwania błędów podczas tworzenia oprogramowania.
  55             Możesz dodać kod, aby wyświetlić informacje o zmiennej, a potem
  56             szybko go usunąć.
  57         </para>
  58         <para>
  59             Zapoznaj się także z komponentem
  60             <link linkend="zend.log.overview">Zend_Log</link> jeśli chcesz
  61             aby kod służący do usuwania błędów był umieszczony w aplikacji na
  62             stałe. Na przykład, możesz użyć poziomu raportowania błędów
  63             <code>DEBUG</code> i obiektu <code>Zend_Log_Writer_Stream</code>,
  64             aby wyświetlać łańcuchy znaków zwracane przez metodę
  65             <code>Zend_Debug::dump()</code>.
  66         </para>
  67     </tip>
  68
  69 </sect1>