PHPackages                             golgote/console\_getargs2 - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [CLI & Console](/categories/cli)
4. /
5. golgote/console\_getargs2

ActiveLibrary[CLI & Console](/categories/cli)

golgote/console\_getargs2
=========================

Console arguments parser and rules.

1.0.0(11y ago)094BSD-2-ClausePHPPHP >=5.3.0

Since Jan 3Pushed 11y ago1 watchersCompare

[ Source](https://github.com/golgote/Console_GetArgs2)[ Packagist](https://packagist.org/packages/golgote/console_getargs2)[ RSS](/packages/golgote-console-getargs2/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)DependenciesVersions (2)Used By (0)

Command-line arguments parsing class
====================================

[](#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
-----

[](#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:

```
array(
 longname => array('short'   => Short option name,
                   'max'     => Maximum arguments for option,
                   'min'     => Minimum arguments for option,
                   'default' => Default option argument,
                   'desc'    => Option description)
)
```

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

[](#example-1)

```
require_once 'Console/Getargs2.php';
try {
  $args = new Console_Getargs2($config);
} catch (Console_GetArgs2_UserException $e) {
  echo $e->getHelp();
} catch (Console_GetArgs2_Exception $e) {
  echo $e->getMessage();
}
echo 'Verbose: '.$args['verbose']."\n";
if (isset($args['bs'])) {
 echo 'Block-size: '.(is_array($args['bs']) ? implode(', ', $args['bs'])."\n" : $args['bs']."\n");
} else {
 echo "Block-size: undefined\n";
}
echo 'Files: '.(isset($args['file']) ? implode(', ', $args['file'])."\n" : "undefined\n");
if (isset($args['n'])) {
 echo 'Nodes: '.(is_array($args['n']) ? implode(', ', $args['n'])."\n" : $args['n']."\n");
} else {
 echo "Nodes: undefined\n";
}
echo 'Log: '.$args['log']."\n";
echo 'Debug: '.(isset($args['d']) ? "YES\n" : "NO\n");
```

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](https://github.com/pear/Console_Getargs/tree/master/examples)

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

4144d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/e8175db70d94e25d6c2907304db066038bb6e2e476542d5c95105a4760612e44?d=identicon)[golgote](/maintainers/golgote)

---

Top Contributors

[![golgote](https://avatars.githubusercontent.com/u/12360?v=4)](https://github.com/golgote "golgote (6 commits)")

---

Tags

cliconsolegetopt

### Embed Badge

![Health badge](/badges/golgote-console-getargs2/health.svg)

```
[![Health](https://phpackages.com/badges/golgote-console-getargs2/health.svg)](https://phpackages.com/packages/golgote-console-getargs2)
```

###  Alternatives

[symfony/console

Eases the creation of beautiful and testable command line interfaces

9.8k1.1B11.2k](/packages/symfony-console)[nunomaduro/collision

Cli error handling for console/command-line PHP applications.

4.6k331.8M8.5k](/packages/nunomaduro-collision)[nunomaduro/termwind

It's like Tailwind CSS, but for the console.

2.5k239.8M285](/packages/nunomaduro-termwind)[wp-cli/php-cli-tools

Console utilities for PHP

68325.0M364](/packages/wp-cli-php-cli-tools)[php-school/cli-menu

A command line menu helper in PHP

2.0k1.1M27](/packages/php-school-cli-menu)[seld/cli-prompt

Allows you to prompt for user input on the command line, and optionally hide the characters they type

24725.8M17](/packages/seld-cli-prompt)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)