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
|
<?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> ist ein Textbasierter Adater für
Terminals. Er kann automatisch die Terminalbreite erkennen unterstützt aber auch eigene
Breiten. Kann kann definieren welche Elemente mit dem Fortschrittsbalken angezeigt werden
und auch deren Reihenfolge ändern. Man kann auch den Stil des Fortschrittsbalkens selbst
definieren.
</para>
<note>
<title>Automatische Breitenerkennung der Konsole</title>
<para>
<code>shell_exec</code> wird benötigt damit dieses Feature auf *nix basierenden Systemen
funktioniert. Auf Windows, ist die Terminalbreite immer auf 80 Zeichen begrenzt, sodas
dort keine Erkennung notwendig ist.
</para>
</note>
<para>
Man kann auch die Optionen des Adapters entweder über die <code>set*</code> Methoden oder
durch die Übergabe eines Arrays, oder einer Instanz von <classname>Zend_Config</classname>,
an den Constructor mit dem Optionen als ersten Parameter. Die möglichen Optionen sind:
</para>
<itemizedlist>
<listitem>
<para>
<code>outputStream</code>: Ein anderer Ausgabe-Stream wenn man nicht auf STDOUT
streamen will. Kann jeder andere Stream wie <code>php://stderr</code> oder ein Pfad
zu einer Datei sein.
</para>
</listitem>
<listitem>
<para>
<code>width</code>: Entweder ein Integer oder die Konstante
<constant>AUTO</constant> von <classname>Zend_Console_ProgressBar</classname>.
</para>
</listitem>
<listitem>
<para>
<code>elements</code>: Entweder <constant>NULL</constant> für Standard oder ein
Array mit zumindest einer der folgenden Konstanten von
<classname>Zend_Console_ProgressBar</classname> als Wert:
</para>
<itemizedlist>
<listitem>
<para>
<constant>ELEMENT_PERCENT</constant>: Der aktuelle Wert in Prozent.
</para>
</listitem>
<listitem>
<para>
<constant>ELEMENT_BAR</constant>: Die sichtbare Begrenzung welche den
Prozentwert anzeigt.
</para>
</listitem>
<listitem>
<para>
<constant>ELEMENT_ETA</constant>: Die automatisch berechnete ETA. Das
Element wird zuerst nach fünf Sekunden angezeigt, weil es während dieser Zeit
nicht möglich ist korrekte Ergebnisse zu berechnen.
</para>
</listitem>
<listitem>
<para>
<constant>ELEMENT_TEXT</constant>: Eine optionale Statusmeldung über den
aktuelle Fortschritt.
</para>
</listitem>
</itemizedlist>
</listitem>
<listitem>
<para>
<code>textWidth</code>: Breite in Zeichen des <constant>ELEMENT_TEXT</constant>
Elements. Standard ist 20.
</para>
</listitem>
<listitem>
<para>
<code>charset</code>: Zeichensatz des
<constant>ELEMENT_TEXT</constant> Elements. Standardwert ist utf-8.
</para>
</listitem>
<listitem>
<para>
<code>barLeftChar</code>: Ein String der auf der linken Seite des Zeigers des
Fortschrittsbalkens verwendet wird.
</para>
</listitem>
<listitem>
<para>
<code>barRightChar</code>: Ein String der auf der rechten Seite des Zeigers des
Fortschrittsbalkens verwendet wird.
</para>
</listitem>
<listitem>
<para>
<code>barIndicatorChar</code>: Ein String der für den Zeiger des Fortschrittsbalkens
verwendet wird. Er kann auch leer sein.
</para>
</listitem>
</itemizedlist>
</sect3>
|
