Class HelpCommand
Print out command list
Property Summary
Method Summary
-
abort() public
Halt the current process with a StopException.
-
asText() protected
Output text.
-
asXml() protected
Output as XML
-
buildOptionParser() protected
Gets the option parser instance and configures it.
-
defaultName() public static
Get the command name.
-
displayHelp() protected
Output help content
-
execute() public
Main function Prints out the list of commands.
-
executeCommand() public
Execute another command with the provided set of arguments.
-
getDescription() public static
Get the command description.
-
getName() public
Get the command name.
-
getOptionParser() public
Get the option parser.
-
getRootName() public
Get the root command name.
-
getShortestName() protected
-
initialize() public
Hook method invoked by CakePHP when a command is about to be executed.
-
outputPaths() protected
Output relevant paths if defined
-
run() public
Run the command.
-
setCommandCollection() public
Set the command collection being used.
-
setName() public
Set the name this command uses in the collection.
-
setOutputLevel() protected
Set the output level based on the Arguments.
Method Detail
abort() ¶ public
abort(int $code = self::CODE_ERROR): voidHalt the current process with a StopException.
Parameters
-
int$code optional The exit code to use.
Returns
voidThrows
Cake\Console\Exception\StopExceptionasText() ¶ protected
asText(Cake\Console\ConsoleIo $io, iterable $commands): voidOutput text.
Parameters
-
Cake\Console\ConsoleIo$io The console io
-
iterable$commands The command collection to output.
Returns
voidasXml() ¶ protected
asXml(Cake\Console\ConsoleIo $io, iterable $commands): voidOutput as XML
Parameters
-
Cake\Console\ConsoleIo$io The console io
-
iterable$commands The command collection to output
Returns
voidbuildOptionParser() ¶ protected
buildOptionParser(Cake\Console\ConsoleOptionParser $parser): Cake\Console\ConsoleOptionParserGets the option parser instance and configures it.
Parameters
-
Cake\Console\ConsoleOptionParser$parser The parser to build
Returns
Cake\Console\ConsoleOptionParserdefaultName() ¶ public static
defaultName(): stringGet the command name.
Returns the command name based on class name.
For e.g. for a command with class name UpdateTableCommand the default
name returned would be 'update_table'.
Returns
stringdisplayHelp() ¶ protected
displayHelp(Cake\Console\ConsoleOptionParser $parser, Cake\Console\Arguments $args, Cake\Console\ConsoleIo $io): voidOutput help content
Parameters
-
Cake\Console\ConsoleOptionParser$parser The option parser.
-
Cake\Console\Arguments$args The command arguments.
-
Cake\Console\ConsoleIo$io The console io
Returns
voidexecute() ¶ public
execute(Cake\Console\Arguments $args, Cake\Console\ConsoleIo $io): intMain function Prints out the list of commands.
Parameters
-
Cake\Console\Arguments$args The command arguments.
-
Cake\Console\ConsoleIo$io The console io
Returns
intexecuteCommand() ¶ public
executeCommand(Cake\Console\CommandInterface|string $command, array $args = [], Cake\Console\ConsoleIo|null $io = null): int|nullExecute another command with the provided set of arguments.
If you are using a string command name, that command's dependencies will not be resolved with the application container. Instead you will need to pass the command as an object with all of its dependencies.
Parameters
-
Cake\Console\CommandInterface|string$command The command class name or command instance.
-
array$args optional The arguments to invoke the command with.
-
Cake\Console\ConsoleIo|null$io optional The ConsoleIo instance to use for the executed command.
Returns
int|nullgetDescription() ¶ public static
getDescription(): stringGet the command description.
Returns
stringgetOptionParser() ¶ public
getOptionParser(): Cake\Console\ConsoleOptionParserGet the option parser.
You can override buildOptionParser() to define your options & arguments.
Returns
Cake\Console\ConsoleOptionParserThrows
RuntimeExceptionWhen the parser is invalid
getShortestName() ¶ protected
getShortestName(array<string> $names): stringParameters
-
array<string>$names Names
Returns
stringinitialize() ¶ public
initialize(): voidHook method invoked by CakePHP when a command is about to be executed.
Override this method and implement expensive/important setup steps that should not run on every command run. This method will be called before the options and arguments are validated and processed.
Returns
voidoutputPaths() ¶ protected
outputPaths(Cake\Console\ConsoleIo $io): voidOutput relevant paths if defined
Parameters
-
Cake\Console\ConsoleIo$io IO object.
Returns
voidrun() ¶ public
run(array $argv, Cake\Console\ConsoleIo $io): int|nullRun the command.
Parameters
-
array$argv -
Cake\Console\ConsoleIo$io
Returns
int|nullsetCommandCollection() ¶ public
setCommandCollection(Cake\Console\CommandCollection $commands): voidSet the command collection being used.
Parameters
-
Cake\Console\CommandCollection$commands
Returns
voidsetName() ¶ public
setName(string $name): $thisSet the name this command uses in the collection.
Generally invoked by the CommandCollection when the command is added. Required to have at least one space in the name so that the root command can be calculated.
Parameters
-
string$name
Returns
$thissetOutputLevel() ¶ protected
setOutputLevel(Cake\Console\Arguments $args, Cake\Console\ConsoleIo $io): voidSet the output level based on the Arguments.
Parameters
-
Cake\Console\Arguments$args The command arguments.
-
Cake\Console\ConsoleIo$io The console io
Returns
void