PageRenderTime 17ms CodeModel.GetById 10ms app.highlight 4ms RepoModel.GetById 1ms app.codeStats 0ms

/docs/languages/de/modules/zend.console.getopt.rules.rst

https://github.com/gullij/zf2-documentation
ReStructuredText | 93 lines | 63 code | 30 blank | 0 comment | 0 complexity | 9747074385b82676c2e9c87bdb7aeefa MD5 | raw file
 1.. EN-Revision: none
 2.. _zend.console.getopt.rules:
 3
 4Definieren von Getopt Regeln
 5============================
 6
 7Der Constructor für die ``Zend\Console\Getopt`` Klasse nimmt ein bis drei Argumente. Das erste Argument definiert
 8welche Optionen durch die Anwendung unterstützt werden. Diese Klasse unterstützt alternative Syntaxformen für
 9das definieren der Optionen. Die nächsten Sektionen geben Auskunft über das Format und die Verwendung dieser
10Syntaxformen.
11
12Der Constructor nimmt zwei weitere Argumente, welche optional sind. Das zweite Argument kann Kommandozeilen
13Argumente enthalten. Sein Standardwert ist ``$_SERVER['argv']``.
14
15Das dritte Argument des Constructors kann Konfigurationsoptionen enthalten um das Verhalten von
16``Zend\Console\Getopt`` anzupassen. Siehe :ref:`Konfiguration hinzufügen
17<zend.console.getopt.configuration.config>` für eine Referenz der möglichen Optionen.
18
19.. _zend.console.getopt.rules.short:
20
21Optionen mit der kurzen Syntax definieren
22-----------------------------------------
23
24``Zend\Console\Getopt`` unterstützt eine kompakte Syntax wie Sie durch *GNU* Getopt verwendet wird (siehe
25`http://www.gnu.org/software/libc/manual/html_node/Getopt.html`_). Diese Syntax unterstützt nur Einzel-Zeichen
26Flags. In einer einzelnen Zeichenkette, wird jeder Buchstabe angegeben der einem Flag entspricht das durch die
27Anwendung unterstützt wird. Der Buchstabe, gefolgt von einem Doppelpunkt Zeichen (**:**) zeigt ein Flag das einen
28Parameter benötigt.
29
30.. _zend.console.getopt.rules.short.example:
31
32.. rubric:: Verwendung der kurzen Syntax
33
34.. code-block:: php
35   :linenos:
36
37   $opts = new Zend\Console\Getopt('abp:');
38
39Das obige Beispiel zeigt die Verwendung von ``Zend\Console\Getopt`` um die Optionen zu definieren die als ``-a``,
40``-b``, oder ``-p`` angegeben werden können. Das letzte Flag benötigt einen Parameter.
41
42Die kurze Syntax ist limitiert auf Flags mit einzelnen Zeichen. Aliase, Parametertypen und Hilfszeichenketten
43werden in der kurzen Syntax nicht unterstützt.
44
45.. _zend.console.getopt.rules.long:
46
47Optionen mit der langen Syntax definieren
48-----------------------------------------
49
50Eine andere Syntax mit mehr Möglichkeiten ist auch vorhanden. Diese Syntax ermöglicht es Aliase für Flags, Typen
51von Optionsparametern und auch Hilfszeichenkette zu definieren um die Verwendung für den Benutzer zu beschreiben.
52Statt einer einzelnen Zeichenkette die in der kurzen Syntax verwendet wird um die Optionen zu definieren, verwendet
53die lange Syntax ein assoziatives Array als erstes Argument für den Constructor.
54
55Der Schlüssel jeden Elements des assoziativen Array ist eine Zeichenkette mit einem Format dass das Flag benennt,
56mit jedem Alias, getrennt durch ein Pipe Symbol ("**|**"). Dieser Serie von Flag Aliasen folgende, wenn die Option
57einen Parameter benötigt, ist ein Gleichheitszeichen ("**=**") mit einem Buchstaben der für den **Typ** dieses
58Parameters steht:
59
60- "**=s**" für einen Zeichenketten Parameter
61
62- "**=w**" für einen Wort Parameter (eine Zeichenkette die keine Leerzeichen enthält)
63
64- "**=i**" für einen Integer Parameter
65
66Wenn der Parameter optional ist, kann ein Bindestrich ("**-**") statt des Gleichheitszeichens verwendet werden.
67
68Der Wert jeden Elements in diesem assiziativen Array ist eine Hilfszeichenkette um dem Benutzer zu beschreiben wie
69das Programm verwendet werden kann.
70
71.. _zend.console.getopt.rules.long.example:
72
73.. rubric:: Verwendung der langen Syntax
74
75.. code-block:: php
76   :linenos:
77
78   $opts = new Zend\Console\Getopt(
79       array(
80           'apfel|a'    => 'Apfel Option, ohne Parameter',
81           'banane|b=i' => 'Bananen Option, mit benötigtem Integer Parameter',
82           'pfirsich|p-s' => 'Pfirsich Option, mit optionalem String Parameter'
83       )
84   );
85
86In der obigen Beispieldefinition, sind drei Optionen. ``--apfel`` und ``-a`` sind Aliase füreinander, und diese
87Option nimmt keinen Parameter. ``--banane`` und ``-b`` sind Aliase füreinander, und diese Option nimmt einen
88notwendigen Integer Parameter. Letztendlich, ``--pfirsich`` und ``-p`` sind Aliase füreinander, und diese Option
89kann einen Optionalen Zeichenketten Parameter annehmen.
90
91
92
93.. _`http://www.gnu.org/software/libc/manual/html_node/Getopt.html`: http://www.gnu.org/software/libc/manual/html_node/Getopt.html