Class ConsoleInputOption
An object to represent a single option used in the command line. ConsoleOptionParser creates these when you use addOption()
Property Summary
-
$_boolean protected
bool
Is the option a boolean option. Boolean options do not consume a parameter.
-
$_choices protected
array
An array of choices for the option.
-
$_default protected
mixed
Default value for the option
-
$_help protected
string
Help text for the option.
-
$_multiple protected
bool
Can the option accept multiple value definition.
-
$_name protected
string
Name of the option
-
$_short protected
string
Short (1 character) alias for the option.
Method Summary
-
__construct() public
Make a new Input Option
-
acceptsMultiple() public
Check if this option accepts multiple values.
-
defaultValue() public
Get the default value for this option
-
help() public
Generate the help for this this option.
-
isBoolean() public
Check if this option is a boolean option
-
name() public
Get the value of the name attribute.
-
short() public
Get the value of the short attribute.
-
usage() public
Get the usage value for this option
-
validChoice() public
Check that a value is a valid choice for this option.
-
xml() public
Append the option's xml into the parent.
Method Detail
__construct() ¶ public
__construct(string|array $name, string $short = '', string $help = '', bool $boolean = false, string $default = '', array $choices = [], bool $multiple = false)
Make a new Input Option
Parameters
-
string|array
$name The long name of the option, or an array with all the properties.
-
string
$short optional The short alias for this option
-
string
$help optional The help text for this option
-
bool
$boolean optional Whether this option is a boolean option. Boolean options don't consume extra tokens
-
string
$default optional The default value for this option.
-
array
$choices optional Valid choices for this option.
-
bool
$multiple optional Whether this option can accept multiple value definition.
Throws
Cake\Console\Exception\ConsoleException
acceptsMultiple() ¶ public
acceptsMultiple(): bool
Check if this option accepts multiple values.
Returns
bool
help() ¶ public
help(int $width = 0): string
Generate the help for this this option.
Parameters
-
int
$width optional The width to make the name of the option.
Returns
string
validChoice() ¶ public
validChoice(string $value): bool
Check that a value is a valid choice for this option.
Parameters
-
string
$value The choice to validate.
Returns
bool
Throws
Cake\Console\Exception\ConsoleException
xml() ¶ public
xml(SimpleXMLElement $parent): SimpleXMLElement
Append the option's xml into the parent.
Parameters
-
SimpleXMLElement
$parent The parent element.
Returns
SimpleXMLElement
Property Detail
$_boolean ¶ protected
Is the option a boolean option. Boolean options do not consume a parameter.
Type
bool