alxmsl / cli
Simple library for php-cli script options support
Installs: 18 174
Dependents: 6
Suggesters: 0
Security: 0
Stars: 5
Watchers: 2
Forks: 1
Open Issues: 0
Requires (Dev)
- phpunit/phpunit: 4.7.*
This package is not auto-updated.
Last update: 2024-12-21 17:17:22 UTC
README
This is simple set of classes for support php-cli script options
Advantages
- Lightweight - only two classes for work with command options
- Events helps to up your code flexibility
- Self-autoloading. You need to include only one file
- Independed namespace helps to use Cli on different projects and frameworks
Posibilities
You can set short or long option name, while call php-cli script. The same lines may be equal
php script.php -a # short name of option apply
php script.php --apply
You can use boolean or string option values
php script.php --apply # option 'apply' has boolean value
php script.php --change=all -a # option 'change' has string value 'all', and option 'aplly' has boolean value true
php script.php --change=all # option 'aplly' has boolean value false. It's not set
If you use string values, that containing spaces, quote its
php script.php --change="all the world"
You can create required options or not
php script.php -s Test # option 'script' is required
...if you call 'script.php' without 's' option, you will see
php script.php
PHP Fatal error: Uncaught exception 'Cli\RequiredOptionException' in /root/CommandPosix.php:79
On each option you can add callback (see Usage Example). Callback function can use first parameter as an option name, second as value
$Command->appendParameter($Option, function($name, $value) {
echo 'option \'' . $name . '\' value is \'' . $value . '\'' . "\n";
});
you will see
php script.php --script=noscript
option 'script' value is 'noscript'
Usage example
// Firstly include base class
include('../source/Cli.php');
use \Cli\CommandPosix,
\Cli\Option;
// Just create command line option instances
$OptionHelp = new Option('help', 'h', 'show help screen option');
// Create command instance
$Command = new CommandPosix();
// Append created option for help to command
$Command->appendHelpParameter('show help screen option');
// Append one required option. And...
$Command->appendParameter(new Option('option', 'o', 'some option', Option::TYPE_BOOLEAN, true));
// ...just parse the command
$Command->parse();
If you will need the exception when required options value will not set, try:
$Command->parse(true);
You will see something like this:
alxmsl:~/cli/tests$ php usage.php
PHP Fatal error: Uncaught exception 'Cli\RequiredOptionException' with message 'option' in /home/alxmsl/cli/source/CommandPosix.php:92
Stack trace:
#0 /home/alxmsl/cli/tests/usage.php(27): Cli\CommandPosix->parse(true)
#1 {main}
thrown in /home/alxmsl/sources/cli/CommandPosix.php on line 92
License
Copyright 2015 Alexey Maslov alexey.y.maslov@gmail.com
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.