W3cubDocs

/CakePHP 4.4

Class ConsoleInputArgument

An object to represent a single argument used in the command line. ConsoleOptionParser creates these when you use addArgument()

Namespace: Cake\Console
See: \Cake\Console\ConsoleOptionParser::addArgument()

Property Summary

  • $_choices protected
    array<string>

    An array of valid choices for this argument.

  • $_help protected
    string

    Help string

  • $_name protected
    string

    Name of the argument.

  • $_required protected
    bool

    Is this option required?

Method Summary

  • __construct() public

    Make a new Input Argument

  • help() public

    Generate the help for this argument.

  • isEqualTo() public

    Checks if this argument is equal to another argument.

  • isRequired() public

    Check if this argument is a required argument

  • name() public

    Get the value of the name attribute.

  • usage() public

    Get the usage value for this argument

  • validChoice() public

    Check that $value is a valid choice for this argument.

  • xml() public

    Append this arguments XML representation to the passed in SimpleXml object.

Method Detail

__construct() public 

__construct(array<string, mixed>|string $name, string $help = '', bool $required = false, array<string> $choices = [])

Make a new Input Argument

Parameters

array<string, mixed>|string $name

The long name of the option, or an array with all the properties.

string $help optional

The help text for this option

bool $required optional

Whether this argument is required. Missing required args will trigger exceptions

array<string> $choices optional

Valid choices for this option.

help() public 

help(int $width = 0): string

Generate the help for this argument.

Parameters

int $width optional

The width to make the name of the option.

Returns

string

isEqualTo() public 

isEqualTo(Cake\Console\ConsoleInputArgument $argument): bool

Checks if this argument is equal to another argument.

Parameters

Cake\Console\ConsoleInputArgument $argument

ConsoleInputArgument to compare to.

Returns

bool

isRequired() public 

isRequired(): bool

Check if this argument is a required argument

Returns

bool

name() public 

name(): string

Get the value of the name attribute.

Returns

string

usage() public 

usage(): string

Get the usage value for this argument

Returns

string

validChoice() public 

validChoice(string $value): true

Check that $value is a valid choice for this argument.

Parameters

string $value

The choice to validate.

Returns

true

Throws

Cake\Console\Exception\ConsoleException

xml() public 

xml(SimpleXMLElement $parent): SimpleXMLElement

Append this arguments XML representation to the passed in SimpleXml object.

Parameters

SimpleXMLElement $parent

The parent element.

Returns

SimpleXMLElement

Property Detail

$_choices protected

An array of valid choices for this argument.

Type

array<string>

$_help protected

Help string

Type

string

$_name protected

Name of the argument.

Type

string

$_required protected

Is this option required?

Type

bool

© 2005–present The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
https://api.cakephp.org/4.4/class-Cake.Console.ConsoleInputArgument.html