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
|
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 24249 -->
<!-- Reviewed: no -->
<sect1 id="zend.console.getopt.introduction">
<title>Introduction</title>
<para>
La classe <classname>Zend_Console_Getopt</classname> aide les applications lancées en ligne
de commande à analyser les options et arguments.
</para>
<para>
Les utilisateurs peuvent spécifier des arguments en ligne de commande quand ils
exécutent votre application. Ces arguments ont du sens dans l'application : changer son
comportement, choisir des ressources, ou spécifier des paramètres. Beaucoup d'options ont
une signification usuelle, par exemple "<command>--verbose</command>" permet la production
d'informations supplémentaires dans beaucoup d'applications. D'autres options peuvent avoir
un sens qui est différent pour chaque application. Par exemple, "<command>-c</command>"
prend des sens différents lorsqu'il est utilisé dans <command>grep</command>,
<command>ls</command>, et <command>tar</command>.
</para>
<para>
Nous avons ci-dessous quelques définitions de termes. L'usage commun des termes
varie, mais cette documentation utilisera les définitions ci-dessous.
</para>
<itemizedlist>
<listitem>
<para>
"argument" : une chaîne de caractères qui
apparaît dans la ligne de commande après le nom de la commande. Les arguments
peuvent être des options ou bien peut apparaître sans option, appeler des
ressources sur lesquelles la commande agit.
</para>
</listitem>
<listitem>
<para>
"option" : un argument qui signifie que la commande va changer
son comportement par défaut d'une manière quelconque.
</para>
</listitem>
<listitem>
<para>
"flag" (drapeau) : la première partie d'une option, identifie le but de l'option.
Un drapeau est précédé conventionnellement par un ou deux tirets
("<command>-</command>" or "<command>--</command>"). Un drapeau court comporte un
caractère unique. Un drapeau long est une chaîne de plusieurs caractères. Un tiret
simple précède un drapeau court ou un groupe de drapeaux courts. Un tiret double
précède un drapeau long. Les drapeaux longs ne peuvent pas être groupés.
</para>
</listitem>
<listitem>
<para>
"parameter" (paramètre) : la seconde partie d'une option ; une
donnée qui peut accompagner un drapeau, si c'est applicable à l'option donnée. Par
exemple, beaucoup de commandes acceptent "<command>--verbose</command>",
mais typiquement cette option n'a aucun paramètre. Cependant, une option
comme "<command>--user</command> a presque toujours besoin d'un paramètre
à sa suite.
</para>
<para>
Un paramètre peut être donné comme un argument séparé après un argument de
drapeau, ou comme faisant partie de la même chaîne de caractères, séparé du drapeau
par le symbole égal ("<command>=</command>"). La dernière forme est autorisée
seulement avec des drapeaux longs. Par exemple, <command>-u username</command>,
<command>--user username</command>, et <command>--user=username</command> sont
des formats supportés par <classname>Zend_Console_Getopt</classname>.
</para>
</listitem>
<listitem>
<para>
"cluster" (groupe) : les drapeaux courts peuvent être combinés dans une
chaîne de caractère unique précédée par un tiret simple. Par exemple, "
<command>ls -1str</command>" emploie un groupe de quatre drapeaux courts. Cette
commande est équivalente à "
<command>ls -1 -s -t -r</command>". Seuls les drapeaux courts peuvent être groupés.
Vous ne pouvez pas faire un groupe de drapeaux longs.
</para>
</listitem>
</itemizedlist>
<para>
Par exemple, dans "<command>mysql --user=root mabase</command>", "<command>mysql</command>"
est la <emphasis>commande</emphasis>, "<command>--user=root</command>" est une
<emphasis>option</emphasis>, "<command>--user</command>" est un
<emphasis>drapeau</emphasis>, "<command>root</command>" est un
<emphasis>paramètre</emphasis> de l'option, et
"<command>mabase</command>" est un argument mais pas une option dans notre définition.
</para>
<para>
<classname>Zend_Console_Getopt</classname> fournit une interface pour déclarer quels
drapeaux sont valides pour votre application, produit une erreur et un message s'ils
emploient un drapeau invalide, et transmet à votre application les drapeaux spécifiés
par l'utilisateur.
</para>
<note>
<title>Getopt n'est pas une application framework</title>
<para>
<classname>Zend_Console_Getopt</classname> <emphasis>n'interprète
pas</emphasis> le sens des drapeaux ou des paramètres, cette classe n'exécute
pas non plus de processus d'application ou n'invoque pas le code d'application. Vous
devez implémenter ces actions dans votre propre code d'application. Vous pouvez
utiliser la classe <classname>Zend_Console_Getopt</classname> pour analyser la ligne
d'instruction et fournir des méthodes orientées objet pour savoir quelles options ont
été données par un utilisateur, mais le code pour utiliser ces données pour appeler les
parties de votre application devra être dans une autre classe <acronym>PHP</acronym>.
</para>
</note>
<para>
Les sections suivantes décrivent l'utilisation de
<classname>Zend_Console_Getopt</classname>.
</para>
</sect1>
|
