documentation/manual/he/module_specs/Zend_Debug.xml

   1 <sect1 id="zend.debug.dumping">
   2
   3     <title>הצגת משתנים</title>
   4
   5     <para>
   6         המתודה הסטטית <code>Zend_Debug::dump()</code> מדפיסה או מחזירה מידע אודות משתנה כלשהו.
   7         דרך זו היא פשוטה שימושית ונפוצה, מאחר והיא לא דורשת שום קריאה מוקדמת למחלקות כלשהן, כלים מסויימים או סביבות עבודה כלשהן.
   8     </para>
   9
  10     <example id="zend.debug.dumping.example">
  11         <title>דוגמא לשימוש</title>
  12         <programlisting role="php"><![CDATA[
  13
  14 Zend_Debug::dump($var, $label=null, $echo=true);
  15 ]]>
  16         </programlisting>
  17     </example>
  18
  19     <para>
  20         המשתנה <code>$var</code>  מגדיר את המשתנה שכל המידע שלו יודפס בעזרת המתודה.
  21     </para>
  22
  23     <para>
  24         ערך <code>$label</code> הוא סטרינג אשר יופיע לפני התוכן שיודפס אודות המשתנה הנוכחי.
  25         שימושי כשהנכם רוצים להציג כמה נתונים אודות כמה ערכים בו זמנית וכדי שיהיה ניתן להפריד ביניהם.
  26     </para>
  27
  28     <para>
  29         המשתנה <code>$echo</code> מגדיר בין אם להדפיס את זה למסדך או להחזיר את זה.
  30         במידה וזה <code>true</code>, כל התוכן יודפס למסך.
  31         במידה וזה <code>false</code> הערך יוזחר למשתנה שיוצג אל המתודה.
  32         ללא קשר למשתנה הזה שיוגדר המתודה תמיד תחזיר את המידע ובמידה והוצב משתנה אל המתודה אז יהיה ניתן להדפיס אותו גם כן.
  33     </para>
  34
  35     <para>
  36         יהיה שימושי להבין שבאופן פנימי, <code>Zend_Debug::dump()</code> עוטפת את התוכן שהיא מציגה ב <ulink url="http://php.net/var_dump"><code>var_dump()</code></ulink>.
  37         אם המתודה מבחינה שהתוכן שאמור להיות מוצג הוא תוכן HTML, התוכן שיודפס ב  <code>var_dump()</code> קודם כל עובר דרך <ulink url="http://php.net/htmlspecialchars"><code>htmlspecialchars()</code></ulink>
  38         ולאחר מכן מוצג כשהוא עטוף ב <code>&lt;pre&gt;</code>.
  39     </para>
  40
  41     <tip>
  42         <title>ניפוי שגיאות בעזרת Zend_Log</title>
  43         <para>
  44             שימוש ב <code>Zend_Debug::dump()</code> היא הדרך הטובה ביותר להצגת נתונים אודות משתנים בתהליך הפיתוח.
  45             ניתן להוסיף קוד שיציג את התוכן של משתנה ולאחר מכן להסיר את אותו הקוד מהר מאוד.
  46         </para>
  47         <para>
  48             כמו כן ניתן לשקול להשתמש ברכיב <link linkend="zend.log.overview">Zend_Log</link> כשעוסקים בניפוי שגיאות קבוע יותר.
  49             לדוגמא, נתן להשתמש ברמת הניפוי <code>DEBUG</code> ומתודות הכתיבה של Zend_Log כדי להציג את הסטרינג שהוחזר באמצעות <code>Zend_Debug::dump()</code>.
  50         </para>
  51     </tip>
  52
  53 </sect1>
  54 <!--
  55 vim:se ts=4 sw=4 et:
  56 -->