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
124
125
126
127
128
129
130
131
132
133
134
|
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 24249 -->
<!-- Reviewed: no -->
<sect1 id="zend.console.getopt.rules">
<title>Déclarer les règles Getopt</title>
<para>
Le constructeur de la classe <classname>Zend_Console_Getopt</classname> prend un à trois
arguments. Le premier argument déclare quelles options sont supportées par votre
application. Cette classe supporte des formes de syntaxe alternatives pour déclarer les
options. Voir les sections ci-dessous pour le format et l'utilisation de ces formes de
syntaxe.
</para>
<para>
Le constructeur prend deux arguments supplémentaires, qui sont facultatifs. Le
deuxième argument peut contenir les arguments de la ligne de commande. La valeur par défaut
est <varname>$_SERVER['argv']</varname>.
</para>
<para>
Le troisième argument du constructeur peut contenir des options de configuration pour
adapter le comportement de <classname>Zend_Console_Getopt</classname>. Voir la section
<link linkend="zend.console.getopt.configuration.config">Ajouter une
configuration</link> pour la référence des options disponibles.
</para>
<sect2 id="zend.console.getopt.rules.short">
<title>Déclarer des options avec la syntaxe courte</title>
<para>
<classname>Zend_Console_Getopt</classname> supporte une syntaxe compacte semblable à
cela employée par <acronym>GNU</acronym> Getopt (voir
<ulink
url="http://www.gnu.org/software/libc/manual/html_node/Getopt.html">http://www.gnu.org/software/libc/manual/html_node/Getopt.html</ulink>).
Cette syntaxe supporte seulement des drapeaux courts (1 seul caractère). Dans une
chaîne de caractère unique, vous entrez chacune des lettres qui correspondent aux
drapeaux supportés par votre application. Une lettre suivie d'un caractère deux points
("<emphasis>:</emphasis>") indique un drapeau qui exige un paramètre.
</para>
<example id="zend.console.getopt.rules.short.example">
<title>Utiliser la syntaxe courte</title>
<programlisting language="php"><![CDATA[
$opts = new Zend_Console_Getopt('abp:');
]]></programlisting>
</example>
<para>
L'exemple ci-dessus montre l'utilisation de <classname>Zend_Console_Getopt</classname>
pour déclarer que des options peuvent être données en tant que "<command>-a</command>",
"<command>-b</command>" ou "<command>-p</command>". Le dernier drapeau exige un
paramètre.
</para>
<para>
La syntaxe courte est limitée aux drapeaux courts (1 seul caractère). Les alias, les
types des paramètres, et les messages d'aide ne sont pas supportés dans la syntaxe
courte.
</para>
</sect2>
<sect2 id="zend.console.getopt.rules.long">
<title>Déclarer des options avec la syntaxe longue</title>
<para>
Une syntaxe différente avec plus de possibilités est également disponible. Cette
syntaxe permet d'indiquer des alias pour les drapeaux, les types de paramètres
d'option, et aussi des messages d'aide pour décrire l'utilisation à l'utilisateur. Au
lieu d'utiliser une chaîne de caractère unique comme pour la syntaxe courte, la syntaxe
longue emploie un tableau associatif comme premier argument du constructeur pour
déclarer les options.
</para>
<para>
La clé de chaque élément du tableau associatif est une chaîne avec un format qui
nomme le drapeau, avec tous ses alias, séparés par le symbole "<emphasis>|</emphasis>".
Après la série des alias, si l'option exige un paramètre, il y a un symbole égal
("<emphasis>=</emphasis>") avec une lettre qui représente le <emphasis>type</emphasis>
du paramètre :
</para>
<itemizedlist>
<listitem>
<para>
"<emphasis>=s</emphasis>" pour un paramètre de type chaîne de caractère.
</para>
</listitem>
<listitem>
<para>
"<emphasis>=w</emphasis>" pour un paramètre de type mot (une chaîne de caractère
qui ne contient pas d'espace).
</para>
</listitem>
<listitem>
<para>"<emphasis>=i</emphasis>" pour un paramètre de type entier (integer).</para>
</listitem>
</itemizedlist>
<para>
Si le paramètre est optionnel, on utilise le tiret ("<emphasis>-</emphasis>") au lieu du
symbole égal.
</para>
<para>
La valeur de chaque élément dans le tableau associatif est un message d'aide pour
décrire à l'utilisateur comment employer votre programme.
</para>
<example id="zend.console.getopt.rules.long.example">
<title>Utiliser la syntaxe longue</title>
<programlisting language="php"><![CDATA[
$opts = new Zend_Console_Getopt(
array(
'abricot|a' => 'option abricot, sans parametres',
'banane|b=i' => 'option banane, avec un parametre entier obligatoire',
'pear|p-s' => 'option pear, avec un parametre chaîne optionel'
)
);
]]></programlisting>
</example>
<para>
Dans l'exemple ci-dessus, il y a trois options. "<command>--abricot</command>" et
"<command>-a</command>" sont des alias l'un pour l'autre et l'option ne prend pas de
paramètres. "<command>--banane</command>" et "<command>-b</command>" sont des alias
l'un pour l'autre et l'option prend un paramètre obligatoire de type entier. Enfin,
"<command>--pear</command>" et "<command>-p</command>" sont des alias l'un pour l'autre
et l'option prend un paramètre optionnel de type chaîne de caractère.
</para>
</sect2>
</sect1>
|
