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
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
|
<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 24249 -->
<!-- Reviewed: no -->
<sect3 id="zend.progressbar.adapter.console">
<title>Zend_ProgressBar_Adapter_Console</title>
<para>
<classname>Zend_ProgressBar_Adapter_Console</classname> est un adaptateur de type
texte pour les terminaux. Il peut automatiquement détecter la largeur du terminal mais
supporte aussi des largeurs personnalisées. Vous pouvez définir quels éléments seront
affichés avec la barre de progression et personnaliser leur ordre. Vous pouvez aussi définir
le style de la barre de progression elle-même.
</para>
<note>
<title>Reconnaissance automatique de la largeur de la console</title>
<para>
<code>shell_exec</code> est nécessaire pour que ceci fonctionne sur les systèmes
de type *nix. Sur Windows, il y a toujours un terminal fixe de 80 caractères de large,
donc la reconnaissance automatique n'est pas nécessaire.
</para>
</note>
<para>
Vous pouvez paramétrer les options de l'adaptateur soit via les méthodes
<code>set*</code> soit en fournissant un tableau ("array") ou une instance
<classname>Zend_Config</classname> en tant que premier paramètre du constructeur. Les
options disponibles sont :
</para>
<itemizedlist>
<listitem>
<para>
<code>outputStream</code> : un flux de sortie différent, si vous ne souhaitez pas
utiliser STDOUT. Peut être n'importe quel autre flux come <code>php://stderr</code>
ou un chemin vers un fichier.
</para>
</listitem>
<listitem>
<para>
<code>width</code> : soit un entier ou la constante <constant>AUTO</constant> de
<classname>Zend_Console_ProgressBar</classname>.
</para>
</listitem>
<listitem>
<para>
<code>elements</code> : soit <constant>NULL</constant> par défaut ou un tableau avec
au moins l'une des constantes de <classname>Zend_Console_ProgressBar</classname>
suivantes comme valeur :
</para>
<itemizedlist>
<listitem>
<para>
<constant>ELEMENT_PERCENT</constant> : la valeur courante en
pourcentage.
</para>
</listitem>
<listitem>
<para>
<constant>ELEMENT_BAR</constant> : la barre qui va représenter le
pourcentage.
</para>
</listitem>
<listitem>
<para>
<constant>ELEMENT_ETA</constant> : le calcul automatique du temps restant
estimé (NDT. : "Estimated Time for Accomplishment"). Cet élément est affiché
pour la première fois qu'après cinq secondes, car durant ce temps, il n'est
pas possible de calculer des résultats précis.
</para>
</listitem>
<listitem>
<para>
<constant>ELEMENT_TEXT</constant> : un message de statut optionnel concernant
le processus courant.
</para>
</listitem>
</itemizedlist>
</listitem>
<listitem>
<para>
<code>textWidth</code> : largeur en caractères de l'élément
<constant>ELEMENT_TEXT</constant>. Par défaut vaut 20.
</para>
</listitem>
<listitem>
<para>
<code>charset</code> : encodage de l'élément <constant>ELEMENT_TEXT</constant>. Par défaut
vaut "utf-8".
</para>
</listitem>
<listitem>
<para>
<code>barLeftChar</code> : un caractère qui est utilisé du côté gauche de
l'indicateur de la barre de progression.
</para>
</listitem>
<listitem>
<para>
<code>barRightChar</code> : un caractère qui est utilisé du côté droit de
l'indicateur de la barre de progression.
</para>
</listitem>
<listitem>
<para>
<code>barIndicatorChar</code> : un caractère qui est utilisé pour l'indicateur
de la barre de progression. Celui-ci peut être vide.
</para>
</listitem>
</itemizedlist>
</sect3>
|
