File: Zend_Debug.xml

package info (click to toggle)
zendframework 1.12.9%2Bdfsg-2
  • links: PTS, VCS
  • area: main
  • in suites: jessie-kfreebsd
  • size: 133,584 kB
  • sloc: xml: 1,311,829; php: 570,173; sh: 170; makefile: 125; sql: 121
file content (69 lines) | stat: -rw-r--r-- 3,023 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
<sect1 id="zend.debug.dumping">

    <title>Wyświetlanie informacji o zmiennych</title>

    <para>
        Statyczna metoda <code>Zend_Debug::dump()</code> wyświetla lub zwraca
        informacje o wyrażeniu. Ta prosta technika usuwania błędów jest często
        używana, ponieważ jest łatwa w użyciu, nie wymaga inicjowania, użycia
        specjalnych narzędzi czy środowiska testowego.
    </para>

    <example id="zend.debug.dumping.example">
        <title>Przykład użycia metody dump()</title>
        <programlisting role="php"><![CDATA[
Zend_Debug::dump($var, $label=null, $echo=true);
]]>
        </programlisting>
    </example>

    <para>
        Argument <code>$var</code> określa wyrażenie lub zmienną, na temat
        której metoda <code>Zend_Debug::dump()</code> ma wyświetlić informacje.
    </para>

    <para>
        Argument <code>$label</code> jest łańcuchem znaków, który zostanie
        dołączony na początku wyniku użycia metody <code>Zend_Debug::dump()</code>.
        Użycie takich etykiet może być użyteczne na przykład wtedy, gdy
        wyświetlasz informacje o wielu zmiennych na jednym ekranie.
    </para>

    <para>
        Wartość logiczna argumentu <code>$echo</code> określa czy wynik użycia
        metody <code>Zend_Debug::dump()</code> ma być wyświetlony, czy nie.
        Jeśli ma wartość <code>true</code>, wynik jest wyświetlony. Niezależnie
        od wartości tego argumentu, metoda na koniec zwraca wynik.
    </para>

    <para>
        Użyteczna może być informacja o tym, że metoda
        <code>Zend_Debug::dump()</code> używa funkcji PHP
        <ulink url="http://php.net/var_dump"><code>var_dump()</code></ulink>.
        Jeśli dane wyjsciowe mają być wyświetlone w przeglądarce, to w wyniku
        zwróconym przez wywołanie metody <code>var_dump()</code> znaki
        specjalne cytowane są za pomocą funkcji
        <ulink url="http://php.net/htmlspecialchars"><code>htmlspecialchars()</code></ulink>,
        a cały wynik zostaje objęty znacznikami (X)HTML <code>&lt;pre&gt;</code>.
    </para>

    <tip>
        <title>Usuwanie błędów za pomocą Zend_Log</title>
        <para>
            Użycie metody <code>Zend_Debug::dump()</code> jest najlepsze do
            doraźnego usuwania błędów podczas tworzenia oprogramowania.
            Możesz dodać kod, aby wyświetlić informacje o zmiennej, a potem
            szybko go usunąć.
        </para>
        <para>
            Zapoznaj się także z komponentem
            <link linkend="zend.log.overview">Zend_Log</link> jeśli chcesz
            aby kod służący do usuwania błędów był umieszczony w aplikacji na
            stałe. Na przykład, możesz użyć poziomu raportowania błędów
            <code>DEBUG</code> i obiektu <code>Zend_Log_Writer_Stream</code>,
            aby wyświetlać łańcuchy znaków zwracane przez metodę
            <code>Zend_Debug::dump()</code>.
        </para>
    </tip>

</sect1>