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
|
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 24249 -->
<!-- Reviewed: no -->
<sect1 id="zend.debug.dumping">
<title>Afficher des informations</title>
<para>
La méthode statique <methodname>Zend_Debug::dump()</methodname> affiche et/ou retourne
les informations concernant une expression. Cette technique simple de débogage est commune,
parce que facile à utiliser de façon ad hoc et n'exigeant aucune initialisation, aucun
outils spéciaux, ou environnement de mise au point.
</para>
<example id="zend.debug.dumping.example">
<title>Exemple avec la méthode dump()</title>
<programlisting language="php"><![CDATA[
Zend_Debug::dump($var, $label = null, $echo = true);
]]></programlisting>
</example>
<para>
L'argument <varname>$var</varname> définit l'expression ou la variable que l'on veut
examiner avec <methodname>Zend_Debug::dump()</methodname>.
</para>
<para>
L'argument <varname>$label</varname> est un texte arbitraire à placer avant la sortie de
<methodname>Zend_Debug::dump()</methodname>. Ceci est utile lorsque vous souhaitez
afficher à l'écran des informations concernant plusieurs variables.
</para>
<para>
Le booléen <varname>$echo</varname> indique s'il faut (ou non) afficher la sortie de
<methodname>Zend_Debug::dump()</methodname>. Si <constant>TRUE</constant>, la sortie
sera affichée. Quel que soit l'état de <varname>$echo</varname>, la sortie est
toujours retournée.
</para>
<para>
Il peut être utile de savoir que la méthode <methodname>Zend_Debug::dump()</methodname>
enveloppe la fonction <acronym>PHP</acronym> <ulink
url="http://php.net/var_dump"><methodname>var_dump()</methodname></ulink>. Si le flux
est reconnu à destination d'un contenu Web, l'affichage de
<methodname>var_dump()</methodname> est échappé avec <ulink
url="http://php.net/htmlspecialchars"><methodname>htmlspecialchars()</methodname></ulink>
et est enveloppé entre des balises (X)HTML <command><pre> et </pre></command>.
</para>
<tip>
<title>Déboguer avec Zend_Log</title>
<para>
Utiliser <methodname>Zend_Debug::dump()</methodname> est ce qui convient le mieux
pour le débogage durant le développement de l'application. Vous pouvez facilement
ajouter ou retirer du code que vous souhaitez visualiser.
</para>
<para>
Vous pouvez aussi considérer le composant <link
linkend="zend.log.overview">Zend_Log</link>si vous souhaitez rendre permanent du
code de débogage. Par exemple, vous pouvez utiliser le niveau de log
<constant>DEBUG</constant> et le <link linkend="zend.log.writers.stream">flux
d'écriture Stream du log</link> pour afficher la chaîne retournée par
<methodname>Zend_Debug::dump()</methodname>.
</para>
</tip>
</sect1>
|
