Download the PHP package golgote/console_getargs2 without Composer
On this page you can find all versions of the php package golgote/console_getargs2. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package console_getargs2
Command-line arguments parsing class
This implementation was freely inspired by a python module called getargs by Vinod Vijayarajan and a perl CPAN module called Getopt::Simple by Ron Savage
This class implements a Command Line Parser that your cli applications can use to parse command line arguments found in $_SERVER['argv'] or a user defined array.
It gives more flexibility and error checking than Console_Getopt. It also performs some arguments validation and is capable to return a formatted help text to the user, based on the configuration it is given.
The class provides the following capabilities:
- Each command line option can take an arbitrary number of arguments.
- Makes the distinction between switches (options without arguments) and options that require arguments.
- Recognizes 'single-argument-options' and 'default-if-set' options.
- Switches and options with arguments can be interleaved in the command line.
- You can specify the maximum and minimum number of arguments an option can take. Use -1 if you don't want to specify an upper bound.
- Specify the default arguments to an option
- Short options can be more than one letter in length.
- A given option may be invoked by multiple names (aliases).
- Understands by default the --help, -h options
- Can return a formatted help text
- Arguments may be specified using the '=' syntax also.
- Short option names may be concatenated (-dvw 100 == -d -v -w 100)
- Can define a default option that will take any arguments added without an option name
- Can pass in a user defined array of arguments instead of using $_SERVER['argv']
Usage
The constructor will return a new Console_Getargs2 object built using the given configuration options. If the configuration or the command line options contain errors, the returned object will in fact be an Exception explaining the cause of the error.
Factory expects an array as parameter.
The format for this array is:
If an option can be invoked by more than one name, they have to be defined by using | as a separator. For example: name1|name2 This works both in long and short names.
max/min are the most/least number of arguments an option accepts.
The 'defaults' field is optional and is used to specify default arguments to an option. These will be assigned to the option if it is not used in the command line. Default arguments can be:
- a single value for options that require a single argument,
- an array of values for options with more than one possible arguments.
Default argument(s) are mandatory for 'default-if-set' options.
If max is 0 (option is just a switch), min is ignored. If max is -1, then the option can have an unlimited number of arguments greater or equal to min.
If max == min == 1, the option is treated as a single argument option.
If max >= 1 and min == 0, the option is treated as a 'default-if-set' option. This implies that it will get the default argument only if the option is used in the command line without any value. (Note: defaults must be specified for 'default-if-set' options)
If the option is not in the command line, the defaults are not applied. If an argument for the option is specified on the command line, then the given argument is assigned to the option. Thus:
- a --debug in the command line would cause debug = 'default argument'
- a --debug 2 in the command line would result in debug = 2 if not used in the command line, debug will not be defined.
Example 1
If you don't want to require any option name for a set of arguments, or if you would like any "leftover" arguments assigned by default, you can create an option named CONSOLE_GETARGS_PARAMS that will grab any arguments that cannot be assigned to another option. The rules for CONSOLE_GETARGS_PARAMS are still the same. If you specify that two values must be passed then two values must be passed. See the example script for a complete example.
More examples : https://github.com/pear/Console_Getargs/tree/master/examples
