Code Quality
Versions & Stats
A powerful option parser toolkit for PHP, supporting type constraints, flag, multiple flag, multiple values and required value checking.
GetOptionKit supports PHP5.3, with fine unit testing with PHPUnit testing framework.
GetOptionKit is object-oriented, it's flexible and extendable.
Powering PHPBrew https://github.com/phpbrew/phpbrew, CLIFramework https://github.com/c9s/CLIFramework and AssetKit https://github.com/c9s/AssetKit
- Simple format.
- Type constrant.
- Multiple value, requried value, optional value checking.
- Auto-generated help text from defined options.
- Support app/subcommand option parsing.
- Option Value Validator
- Option Suggestions
- SPL library.
- HHVM support.
- PHP 5.3+
composer require corneltek/getoptionkitsimple flags:
program.php -a -b -c program.php -abc program.php -vvv # incremental flag v=3 program.php -a -bcwith multiple values:
program.php -a foo -a bar -a zoo -b -b -bspecify value with equal sign:
program.php -a=foo program.php --long=foowith normal arguments:
program.php -a=foo -b=bar arg1 arg2 arg3 program.php arg1 arg2 arg3 -a=foo -b=bar v|verbose flag option (with boolean value true) d|dir: option require a value (MUST require) d|dir+ option with multiple values. d|dir? option with optional value dir:=string option with type constraint of string dir:=number option with type constraint of number dir:=file option with type constraint of file dir:=date option with type constraint of date dir:=boolean option with type constraint of boolean d single character only option dir long option name app [app-opts] [app arguments] app [app-opts] subcommand [subcommand-opts] [subcommand-args] app [app-opts] subcmd1 [subcmd-opts1] subcmd2 [subcmd-opts] subcmd3 [subcmd-opts3] [subcommand arguments....] See more details in the documentation
Please check examples/demo.php.
Run:
% php examples/demo.php -f test -b 123 -b 333Print:
* Available options: -f, --foo <value> option requires a value. -b, --bar <value>+ option with multiple value. -z, --zoo [<value>] option with optional value. -v, --verbose verbose message. -d, --debug debug message. --long long option name only. -s short option name only. Enabled options: * key:foo spec:-f, --foo <value> desc:option requires a value. value => test * key:bar spec:-b, --bar <value>+ desc:option with multiple value. Array ( [0] => 123 [1] => 333 ) useGetOptionKit\OptionCollection; useGetOptionKit\OptionParser; useGetOptionKit\OptionPrinter\ConsoleOptionPrinter; $specs = newOptionCollection; $specs->add('f|foo:', 'option requires a value.' ) ->isa('String'); $specs->add('b|bar+', 'option with multiple value.' ) ->isa('Number'); $specs->add('ip+', 'Ip constraint' ) ->isa('Ip'); $specs->add('email+', 'Email address constraint' ) ->isa('Email'); $specs->add('z|zoo?', 'option with optional value.' ) ->isa('Boolean'); $specs->add('file:', 'option value should be a file.' ) ->isa('File'); $specs->add('v|verbose', 'verbose message.' ); $specs->add('d|debug', 'debug message.' ); $specs->add('long', 'long option name only.' ); $specs->add('s', 'short option name only.' ); $printer = newConsoleOptionPrinter(); echo$printer->render($specs); $parser = newOptionParser($specs); echo"Enabled options: \n"; try{$result = $parser->parse( $argv ); foreach ($result->keysas$key => $spec){print_r($spec)} $opt = $result->keys['foo']; // return the option object.$str = $result->keys['foo']->value; // return the option valueprint_r($opt); var_dump($str)} catch( Exception$e ){echo$e->getMessage()}See https://github.com/c9s/GetOptionKit/wiki for more details.
The option value type help you validate the input, the following list is the current supported types:
stringnumberbooleanfiledateurlemailipipv4ipv6regex
And here is the related sample code:
$opt->add( 'f|foo:' , 'with string type value' ) ->isa('string'); $opt->add( 'b|bar+' , 'with number type value' ) ->isa('number'); $opt->add( 'z|zoo?' , 'with boolean type value' ) ->isa('boolean'); $opt->add( 'file:' , 'with file type value' ) ->isa('file'); $opt->add( 'date:' , 'with date type value' ) ->isa('date'); $opt->add( 'url:' , 'with url type value' ) ->isa('url'); $opt->add( 'email:' , 'with email type value' ) ->isa('email'); $opt->add( 'ip:' , 'with ip(v4/v6) type value' ) ->isa('ip'); $opt->add( 'ipv4:' , 'with ipv4 type value' ) ->isa('ipv4'); $opt->add( 'ipv6:' , 'with ipv6 type value' ) ->isa('ipv6'); $specs->add('r|regex:', 'with custom regex type value') ->isa('Regex', '/^([a-z]+)$/');Please note that currently only
string,number,booleantypes can be validated.
$specs = newOptionCollection; $spec_verbose = $specs->add('v|verbose'); $spec_color = $specs->add('c|color'); $spec_debug = $specs->add('d|debug'); $spec_verbose->description = 'verbose flag'; // ContinuousOptionParser$parser = newContinuousOptionParser( $specs ); $result = $parser->parse(explode('','program -v -d test -a -b -c subcommand -e -f -g subcommand2')); $result2 = $parser->continueParse();GetOptionKit\OptionPrinter can print options for you:
* Available options: -f, --foo option requires a value. -b, --bar option with multiple value. -z, --zoo option with optional value. -v, --verbose verbose message. -d, --debug debug message. --long long option name only. -s short option name only. For application with subcommands is designed by following form:
[app name] [app opts] [subcommand1] [subcommand-opts] [subcommand2] [subcommand-opts] [subcommand3] [subcommand-opts] [arguments] You can check the tests/GetOptionKit/ContinuousOptionParserTest.php unit test file:
// subcommand stack$subcommands = array('subcommand1','subcommand2','subcommand3'); // different command has its own options$subcommandSpecs = array( 'subcommand1' => $cmdspecs, 'subcommand2' => $cmdspecs, 'subcommand3' => $cmdspecs, ); // for saved options$subcommandOptions = array(); // command arguments$arguments = array(); $argv = explode('','program -v -d -c subcommand1 -a -b -c subcommand2 -c subcommand3 arg1 arg2 arg3'); // parse application options first$parser = newContinuousOptionParser( $appspecs ); $app_options = $parser->parse( $argv ); while (! $parser->isEnd()){if (@$subcommands[0] && $parser->getCurrentArgument() == $subcommands[0]){$parser->advance(); $subcommand = array_shift( $subcommands ); $parser->setSpecs( $subcommandSpecs[$subcommand] ); $subcommandOptions[ $subcommand ] = $parser->continueParse()} else{$arguments[] = $parser->advance()} }- Option Spec group.
- option valid value checking.
- custom command mapping.
- main program name should be easy to type, easy to remember.
- subcommand should be easy to type, easy to remember. length should be shorter than 7 characters.
- options should always have long descriptive name
- a program should be easy to check usage.
To list usage of all subcommands or the program itself:
$ prog help To list the subcommand usage
$ prog help subcommand subcommand2 subcommand3 Fork this repository and clone it:
$ git clone git://github.com/c9s/GetOptionKit.git $ cd GetOptionKit $ composer install Run PHPUnit to test:
$ phpunit This project is released under MIT License.