documentation/manual/ru/module_specs/Zend_Debug.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!-- Reviewed: no -->
   3 <sect1 id="zend.debug.dumping">
   4
   5     <title>Дамп переменных</title>
   6
   7     <para>
   8         Статический метод <code>Zend_Debug::dump()</code> выводит или возвращает
   9         информацию о выражении. Это простая техника отладки довольно
  10         распространена, поскольку ее легко использовать применительно
  11         к случаю, и она не требует какой-либо предварительной инициализации,
  12         специальных инструментов или отладочной среды.
  13     </para>
  14
  15     <example id="zend.debug.dumping.example">
  16         <title>Пример использования метода dump()</title>
  17         <programlisting language="php"><![CDATA[
  18 Zend_Debug::dump($var, $label=null, $echo=true);
  19 ]]></programlisting>
  20     </example>
  21
  22     <para>
  23         Аргумент <varname>$var</varname> соответствует выражению или переменной,
  24         информацию о которой должен вывести метод
  25         <code>Zend_Debug::dump()</code>.
  26     </para>
  27
  28     <para>
  29         Аргумент <varname>$label</varname> (заголовок) является строкой, которая
  30         должна предшествовать выводу метода <code>Zend_Debug::dump()</code>.
  31         Использование заголовков может быть полезным в некоторых случаях -
  32         например, при выводе информации о нескольких переменных на одном экране.
  33     </para>
  34
  35     <para>
  36         Булев аргумент <varname>$echo</varname> определяет, должен ли быть отображен
  37         вывод метода <code>Zend_Debug::dump()</code> или нет. Если
  38         он равен <constant>TRUE</constant>, то вывод будет отображен. Независимо от
  39         значения этого аргумента, возвращаемое методом значение будет содержать
  40         его вывод.
  41     </para>
  42
  43     <para>
  44         Может быть небесполезным знать, что метод
  45         <code>Zend_Debug::dump()</code> является оберткой ко встроенной функции
  46         PHP
  47         <ulink url="http://php.net/var_dump"><code>var_dump()</code></ulink>.
  48         Если поток вывода определен как веб-представление, то вывод
  49         <code>var_dump()</code> будет экранирован с помощью функции
  50         <ulink url="http://php.net/htmlspecialchars"><code>htmlspecialchars()</code></ulink>
  51         и окружен (X)HTML тегами <code>&lt;pre&gt;</code>.
  52     </para>
  53
  54     <tip>
  55         <title>Отладка с применением Zend_Log</title>
  56         <para>
  57             <code>Zend_Debug::dump()</code> хорошо применять для отладки
  58             во время разработки приложения. Вы можете быстро
  59             добавлять код для дампа переменной и удалять его.
  60         </para>
  61         <para>
  62             Также рассмотрите возможность использования компоненты
  63             <link linkend="zend.log.overview">Zend_Log</link> при написании
  64             более долговременного отладочного кода. Например, вы можете
  65             использовать уровень журналирования <code>DEBUG</code> и
  66             регистратор Zend_Log_Writer_Stream для вывода строки, возвращенной
  67             <code>Zend_Debug::dump()</code>.
  68         </para>
  69     </tip>
  70
  71 </sect1>
  72 <!--
  73 vim:se ts=4 sw=4 et:
  74 -->