repo_zf1Php7/documentation/manual/de/module_specs/Zend_Debug.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 17782 -->
<!-- Reviewed: no -->
<sect1 id="zend.debug.dumping">

    <title>Variablen ausgeben</title>

    <para>
        Die statische Methode <methodname>Zend_Debug::dump()</methodname> druckt oder gibt
        Informationen, über einen Ausdruck, zurück. Diese einfache Technik des
        Debuggens ist üblich, weil Sie in einer Ad-Hoc Weise einfach zu Verwenden
        ist, und Sie benötigt keine Initialisierung, spezielle Tools oder eine
        Debuggingumgebung.
    </para>

    <example id="zend.debug.dumping.example">
        <title>Beispiel der dump() Methode</title>
        <programlisting language="php"><![CDATA[
Zend_Debug::dump($var, $label=null, $echo=true);
]]></programlisting>
    </example>

    <para>
        Das <varname>$var</varname> Argument definiert den Ausdruck oder die Variable
        über die die <methodname>Zend_Debug::dump()</methodname> Methode Informationen ausgeben
        soll.
    </para>

    <para>
        Das <varname>$label</varname> Argument ist eine Zeichenkette die der Ausgabe von
        <methodname>Zend_Debug::dump()</methodname> vorgestellt wurd. Das kann hilfreich sein,
        zum Beispiel, um Überschriften zu erhalten wenn Informationen über mehrere
        Variablen auf einen Bildschirm ausgegeben werden.
    </para>

    <para>
        Das boolsche Argument <varname>$echo</varname> definiert ob die Ausgabe von
        <methodname>Zend_Debug::dump()</methodname> mit Echo ausgegeben wird oder nicht.
        Wenn Sie <constant>TRUE</constant> ist, wird mit Echo ausgegeben, sonst nicht.
        Unabhängig vom Wert des <varname>$echo</varname> Arguments enthält der
        Rückgabewert dieser Methode die Ausgabe.
    </para>

    <para>
        Es könnte hilfreich sein, zu verstehen das die <methodname>Zend_Debug::dump()</methodname>
        Methode intern die <acronym>PHP</acronym> Funktion
        <ulink url="http://php.net/var_dump"><methodname>var_dump()</methodname></ulink>
        verwendet. Wenn der Ausgabestream als Webdarstellung erkannt wird, wird die
        Ausgabe von <methodname>var_dump()</methodname> mit Hilfe von <ulink
            url="http://php.net/htmlspecialchars"><methodname>htmlspecialchars()</methodname></ulink>
        ausgeführt und umschlossen mit (X)HTML <command>&lt;pre&gt;</command> Tags.
    </para>

    <tip>
        <title>Debuggen mit Zend_Log</title>
        <para>
            Die Verwendung von <methodname>Zend_Debug::dump()</methodname> ist am Besten für
            Ad-Hoc Debuggen wärend der Software Entwicklung. Es kann Code
            hinzugefügt werden um eine Variable auszugeben und der Code kann auch
            wieder sehr schnell entfernt werden.
        </para>
        <para>
            Um permanenteren Debugging-Code zu schreiben sollte die
            <link linkend="zend.log.overview">Zend_Log</link> Komponente verwendet
            werden. Zum Beispiel kann der <constant>DEBUG</constant> Loglevel mit dem
            Stream Logger verwendet werden um die Zeichenkette auszugeben die durch
            <methodname>Zend_Debug::dump()</methodname> zurückgegeben wird.
        </para>
    </tip>

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