Table des matières
La classe Zend_Console_Getopt
aide les applications lancées en ligne de commande à analyser les options et arguments.
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 "--verbose
" permet la production supplémentaire dans beaucoup d'applications. D'autres options peuvent avoir un sens qui est différent pour chaque application. Par exemple, "-c" prend des sens différents lorsqu'ils est utilisé dans grep, ls, et tar.
Nous avons ci-dessous quelques définitions de termes. L'usage commun des termes varie, mais cette documentation utilisera les définitions ci-dessous.
"argument" : une chaîne de carctères (string
) 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.
"option" : un argument qui signifie que la commande va changer son comportement par défaut d'une manière quelconque.
"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 ("-
" or "--
"). 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.
"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 "--verbose
", mais typiquement cette option n'a aucun paramètre. Cependant, une option comme "--user
a presque toujours besoin d'un paramètre à sa suite.
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 ("=
"). La dernière forme est autorisée seulement avec des drapeaux longs. Par exemple, -u username
, --user username
, et --user=username
sont des formats supportés par Zend_Console_Getopt
.
"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, "ls -1str" emploie un groupe de quatre drapeaux courts. Cette commande est équivalente à "ls -1 -s -t -r". Seuls les drapeaux courts peuvent être groupés. Vous ne pouvez pas faire un gorupe de drapeaux ongs.
Par exemple, dans "mysql --user=root mabase
", "mysql
" est la commande, "--user=root
" est une option, "--user
" est un drapeau, "root
" est un paramètre de l'option, et "mabase
" est un argument mais pas une option dans notre définition.
Zend_Console_Getopt
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.
Getopt n'est pas une application framework | |
---|---|
Zend_Console_Getopt n'interprète pas 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 |
Les sections suivantes décrivent l'utilisation de Zend_Console_Getopt
.