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
boolIs the option a boolean option. Boolean options do not consume a parameter.
-
$_choices protected
string[]An array of choices for the option.
-
$_default protected
string|boolDefault value for the option
-
$_help protected
stringHelp text for the option.
-
$_multiple protected
boolCan the option accept multiple value definition.
-
$_name protected
stringName of the option
-
$_short protected
stringShort (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|bool $default = '', string[] $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|bool$default optional The default value for this option.
-
string[]$choices optional Valid choices for this option.
-
bool$multiple optional Whether this option can accept multiple value definition.
Throws
Cake\Console\Exception\ConsoleExceptionacceptsMultiple() ¶ public
acceptsMultiple(): boolCheck if this option accepts multiple values.
Returns
booldefaultValue() ¶ public
defaultValue(): string|boolGet the default value for this option
Returns
string|boolhelp() ¶ public
help(int $width = 0): stringGenerate the help for this this option.
Parameters
-
int$width optional The width to make the name of the option.
Returns
stringname() ¶ public
name(): stringGet the value of the name attribute.
Returns
stringValue of this->_name.
short() ¶ public
short(): stringGet the value of the short attribute.
Returns
stringValue of this->_short.
validChoice() ¶ public
validChoice(string|bool $value): trueCheck that a value is a valid choice for this option.
Parameters
-
string|bool$value The choice to validate.
Returns
trueThrows
Cake\Console\Exception\ConsoleExceptionxml() ¶ public
xml(SimpleXMLElement $parent): SimpleXMLElementAppend the option's xml into the parent.
Parameters
-
SimpleXMLElement$parent The parent element.
Returns
SimpleXMLElementThe parent with this option appended.
Property Detail
$_boolean ¶ protected
Is the option a boolean option. Boolean options do not consume a parameter.
Type
bool