Einführung - Optionen

Einführung - Optionen – Definition und Verarbeitung von Optionen

Optionen definieren

Getopt() unterstützt zwei Arten von Optionen: knappe Optionen (short options ) und ausführliche Optionen (long options ).

Ein Skriptaufruf mit knappen und ausführlichen Optionen

# knappe Optionen
myphpscript -q -l en -o
# wie oben als ausführliche Optionen
myphpscript --quite --lang=en --option
# beide gemischt
myphpscript -q --lang=en -o

Sie müssen angeben, welche Optionen Sie unterstützen wollen. Der zweite Parameter der Methode getopt() benötigt eine Zeichenkette mit der Liste der unterstützen Zeichen. Für das obige Beispiel ist dies minimal:

<?php
$shortoptions 
"qlo";
?>

Die Ordnung der Zeichen spielt keine Rolle. Häufig benötigen Sie Optionen mit (wahlfreien) Parametern. Um auszudrücken, dass eine Option einen Parameter erfordert, müssen Sie ein Doppelpunkt hinzufügen. Ist der Parameter wahlfrei, dann geben Sie zwei Doppelpunkte an, z.B.:

<?php
$shortoptions 
"ql:o::";
?>

Damit sind z.B. die folgenden Skriptaufrufe erlaubt:

myphpscript myphpscript -q myphpscript -q -l en myphpscript -o text myphpscript -o

Dagegen ist der folgende Aufruf NICHT erlaubt:

myphpscript -l

Denn die Option -l erfordert einen Parameter, wenn die Option benutzt wird.

Die ausführlichen Optionen funktionieren identisch, ausser dass sie als Array definiert werden müssen:

<?php
$longoptions 
= array("quite""lang""option");
?>

Für die Definition wahlfreier Parameter benutzen Sie ein Istgleich = und ein doppeltes Istgleich == analog zu den Doppelpunkten der knappen Optionen:

<?php
$longoptions 
= array("quite""lang=""option==");
?>

Das Rückgabe-Array

Der zurückgelieferte Wert ist ein Array mit zwei Elementen: die Liste der verarbeiteten Optionen und die Liste der nicht-wahlfreien Kommandozeilen-Argumente. Jeder Eintrag in der Liste der verarbeiteten Optionen isr ein Paar von Elementen - das Erste gibt die Option an und das Zweite enthält das Argument der Option, wenn es übergeben wurde, ansonsten NULL.

Console_Getopt (Previous) fetch the command-line options (Next)
Last updated: Sun, 19 Dec 2010 — Download Documentation
Do you think that something on this page is wrong? Please file a bug report or add a note.
View this page in:

User Notes:

There are no user contributed notes for this page.