Inhaltsverzeichnis
Die Zend_Console_Getopt Klasse hilft Kommandozeilen Anwendungen
Ihre Optionen und Argumente zu Analysieren.
Benutzer können Kommandozeilen Argumente definieren wenn die Anwendung
ausgeführt wird. Diese Argumente haben für die Anwendung die Bedeutung,
das Verhalten in einem bestimmten Weg zu Ändern oder Ressourcen auszuwählen,
oder Parameter zu definieren. Viele Optionen haben eine einheitliche Bedeutung
entwickelt wie zum Beispiel "--verbose" welches die Ausgabe von
zusätzlicher Ausgabe für viele Anwendungen erlaubt. Andere Optionen haben auch
eine Bedeutung die in jeder Anwendung unterschiedlich ist. Zum Beispiel
erlaubt "-c" unterschiedliche Features in grep,
ls, und tar.
Anbei sind einige Definitionen von Ausdrücken. Die übliche Verwendung der Ausdrücke variiert, aber diese Dokumentation wird die anbei beschriebenen Definitionen verwenden.
"Argument": eine Zeichenkette die in der Kommandozeile dem Namen des Kommandos folgt. Argumente können Optionen sein, oder auch ohne Option vorkommen, um eine Ressource zu benennen die das Kommando verwendet.
"Option": ist ein Argument das andeutet das das Kommando sein Verhalten in einem bestimmten Weg verändern soll.
"Flag": Der erste Teil einer Option, identifiziert den Zweck der Option. Einem Flag werden normalerweise ein oder zwei Bindestriche vorangestellt ("
-" oder "--"). Ein einzelner wird einem Einzel-Zeichen Flag vorangestellt oder einem Verbund von Einzel-Zeichen Flags. Ein doppelter Bindestrich wird einem Mehr-Zeichen Flag vorangestellt. Lange Flags können nicht gebündelt werden.-
"Parameter": Der zweite Teil einer Option; Ein Datenwert der ein Flag begleitet, wenn er zu einer Option passt. Zum Beispiel kann ein Kommando eine "
--verbose" Option akzeptieren, aber typischerweise hat diese Option keine Parameter. Trotzdem wird eine Option wie "--user" immer einen nachfolgenden Parameter benötigen.Ein Parameter kann als seperates Argument angegeben werden der einem Flag Argument folgt, oder als Teil der gleichen Zeichenkette des Arguments, getrennt vom Flag durch ein Gleichheitszeichen ("
="). Die zweite Form wird nur bei langen Flags unterstützt. Zum Beispiel,-u username,--user username, und--user=usernamesind Formen welche durchZend_Console_Getoptunterstützt werden. "Verbund": Mehrere Einzel-Zeichen Flags kombiniert in einem einzelnen Argument als Zeichenkette und vorangestellt durch einen einzelnen Bindestrich. Zum Beispiel "ls -1str" benutzt einen Verbund von vier kurzen Flags. Dieses Kommando ist identisch mit "ls -1 -s -t -r". Nur Einzel-Zeichen Flags können kombiniert werden. Ein Verbund von langen Flags kann nicht erstellt werden.
Zum Beispiel "mysql --user=root mydatabase".
"mysql" ist ein Kommando,
"--user=root" ist eine Option,
"--user" ist ein Flag,
"root" ist ein Parameter für diese Option
und "mydatabase" ist ein Argument aber nicht eine Option laut
unserer Definition.
Zend_Console_Getopt bietet ein Interface um zu definieren welche
Flags für die Anwendung gültig sind, einen Fehler und Benutzungshinweise ausgibt
wenn ein ungültiges Flag verwendet wird, und dem Code der Anwendung bekanntgibt
welche Flags der Benutzer definiert hat.
![[Anmerkung]](images/note.png) |
Getopt ist kein Framework für eine Anwendung |
|---|---|
|
Die folgende Sektion beschreibt die Verwendung vonZend_Console_Getopt.