<sect1 id="zend.debug.dumping">

    <title>הצגת משתנים</title>

    <para>
        המתודה הסטטית <code>Zend_Debug::dump()</code> מדפיסה או מחזירה מידע אודות משתנה כלשהו.
        דרך זו היא פשוטה שימושית ונפוצה, מאחר והיא לא דורשת שום קריאה מוקדמת למחלקות כלשהן, כלים מסויימים או סביבות עבודה כלשהן.
    </para>

    <example id="zend.debug.dumping.example">
        <title>דוגמא לשימוש</title>
        <programlisting role="php"><![CDATA[

Zend_Debug::dump($var, $label=null, $echo=true);
]]>
        </programlisting>
    </example>

    <para>
        המשתנה <code>$var</code>  מגדיר את המשתנה שכל המידע שלו יודפס בעזרת המתודה.
    </para>

    <para>
        ערך <code>$label</code> הוא סטרינג אשר יופיע לפני התוכן שיודפס אודות המשתנה הנוכחי.
        שימושי כשהנכם רוצים להציג כמה נתונים אודות כמה ערכים בו זמנית וכדי שיהיה ניתן להפריד ביניהם.
    </para>

    <para>
        המשתנה <code>$echo</code> מגדיר בין אם להדפיס את זה למסדך או להחזיר את זה.
        במידה וזה <code>true</code>, כל התוכן יודפס למסך.
        במידה וזה <code>false</code> הערך יוזחר למשתנה שיוצג אל המתודה.
        ללא קשר למשתנה הזה שיוגדר המתודה תמיד תחזיר את המידע ובמידה והוצב משתנה אל המתודה אז יהיה ניתן להדפיס אותו גם כן.
    </para>

    <para>
        יהיה שימושי להבין שבאופן פנימי, <code>Zend_Debug::dump()</code> עוטפת את התוכן שהיא מציגה ב <ulink url="http://php.net/var_dump"><code>var_dump()</code></ulink>.
        אם המתודה מבחינה שהתוכן שאמור להיות מוצג הוא תוכן HTML, התוכן שיודפס ב  <code>var_dump()</code> קודם כל עובר דרך <ulink url="http://php.net/htmlspecialchars"><code>htmlspecialchars()</code></ulink>
        ולאחר מכן מוצג כשהוא עטוף ב <code>&lt;pre&gt;</code>.
    </para>

    <tip>
        <title>ניפוי שגיאות בעזרת Zend_Log</title>
        <para>
            שימוש ב <code>Zend_Debug::dump()</code> היא הדרך הטובה ביותר להצגת נתונים אודות משתנים בתהליך הפיתוח.
            ניתן להוסיף קוד שיציג את התוכן של משתנה ולאחר מכן להסיר את אותו הקוד מהר מאוד.
        </para>
        <para>
            כמו כן ניתן לשקול להשתמש ברכיב <link linkend="zend.log.overview">Zend_Log</link> כשעוסקים בניפוי שגיאות קבוע יותר.
            לדוגמא, נתן להשתמש ברמת הניפוי <code>DEBUG</code> ומתודות הכתיבה של Zend_Log כדי להציג את הסטרינג שהוחזר באמצעות <code>Zend_Debug::dump()</code>.
        </para>
    </tip>

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