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
arrayAn array of choices for the option.
-
$_default protected
mixedDefault value for the option
-
$_help protected
stringHelp text for the option.
-
$_name protected
stringName of the option
-
$_short protected
stringShort (1 character) alias for the option.
Method Summary
-
__construct() public
Make a new Input Option
-
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 = [])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.
Throws
Cake\Console\Exception\ConsoleExceptionhelp() ¶ 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 $value): boolCheck that a value is a valid choice for this option.
Parameters
-
string$value The choice to validate.
Returns
boolThrows
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