Class LegacyShellDispatcher
Allows injecting mock IO into shells
Property Summary
Method Summary
-
__construct() public
Constructor
-
_bootstrap() protected
Initializes the environment and loads the CakePHP core.
-
_createShell() protected
Injects mock and stub io components into the shell
-
_dispatch() protected
Dispatch a request.
-
_handleAlias() protected
If the input matches an alias, return the aliased shell name
-
_initEnvironment() protected
Defines current working environment.
-
_shellExists() protected
Check if a shell class exists for the given name.
-
addShortPluginAliases() public
For all loaded plugins, add a short alias
-
alias() public static
Add an alias for a shell command.
-
dispatch() public
Dispatches a CLI request
-
findShell() public
Get shell to use, either plugin shell or application shell
-
help() public
Shows console help. Performs an internal dispatch to the CommandList Shell
-
resetAliases() public static
Clear any aliases that have been set.
-
run() public static
Run the dispatcher
-
shiftArgs() public
Removes first argument and shifts other arguments up
-
version() public
Prints the currently installed version of CakePHP. Performs an internal dispatch to the CommandList Shell
Method Detail
__construct() ¶ public
__construct(array $args = [], bool $bootstrap = true, Cake\Console\ConsoleIo $io = null)Constructor
Parameters
-
array$args optional Argument array
-
bool$bootstrap optional Initialize environment
-
Cake\Console\ConsoleIo$io optional ConsoleIo
_bootstrap() ¶ protected
_bootstrap(): boolInitializes the environment and loads the CakePHP core.
Returns
bool_createShell() ¶ protected
_createShell(string $className, string $shortName): Cake\Console\ShellInjects mock and stub io components into the shell
Parameters
-
string$className Class name
-
string$shortName Short name
Returns
Cake\Console\Shell_dispatch() ¶ protected
_dispatch(array $extra = []): bool|int|nullDispatch a request.
Parameters
-
array$extra optional Extra parameters that you can manually pass to the Shell to be dispatched. Built-in extra parameter is :
requested: if used, will prevent the Shell welcome message to be displayed
Returns
bool|int|nullThrows
Cake\Console\Exception\MissingShellMethodException_handleAlias() ¶ protected
_handleAlias(string $shell): stringIf the input matches an alias, return the aliased shell name
Parameters
-
string$shell Optionally the name of a plugin or alias
Returns
string_initEnvironment() ¶ protected
_initEnvironment(): voidDefines current working environment.
Returns
voidThrows
Cake\Core\Exception\Exception_shellExists() ¶ protected
_shellExists(string $shell): string|falseCheck if a shell class exists for the given name.
Parameters
-
string$shell The shell name to look for.
Returns
string|falseaddShortPluginAliases() ¶ public
addShortPluginAliases(): arrayFor all loaded plugins, add a short alias
This permits a plugin which implements a shell of the same name to be accessed Using the shell name alone
Returns
arrayalias() ¶ public static
alias(string $short, string|null $original = null): string|falseAdd an alias for a shell command.
Aliases allow you to call shells by alternate names. This is most useful when dealing with plugin shells that you want to have shorter names for.
If you re-use an alias the last alias set will be the one available.
Usage
Aliasing a shell named ClassName:
$this->alias('alias', 'ClassName');Getting the original name for a given alias:
$this->alias('alias');Parameters
-
string$short The new short name for the shell.
-
string|null$original optional The original full name for the shell.
Returns
string|falsedispatch() ¶ public
dispatch(array $extra = []): intDispatches a CLI request
Converts a shell command result into an exit code. Null/True are treated as success. All other return values are an error.
Parameters
-
array$extra optional Extra parameters that you can manually pass to the Shell to be dispatched. Built-in extra parameter is :
requested: if used, will prevent the Shell welcome message to be displayed
Returns
intfindShell() ¶ public
findShell(string $shell): Cake\Console\ShellGet shell to use, either plugin shell or application shell
All paths in the loaded shell paths are searched, handles alias dereferencing
Parameters
-
string$shell Optionally the name of a plugin
Returns
Cake\Console\ShellThrows
Cake\Console\Exception\MissingShellExceptionwhen errors are encountered.
help() ¶ public
help(): voidShows console help. Performs an internal dispatch to the CommandList Shell
Returns
voidresetAliases() ¶ public static
resetAliases(): voidClear any aliases that have been set.
Returns
voidrun() ¶ public static
run(array $argv, array $extra = []): intRun the dispatcher
Parameters
-
array$argv The argv from PHP
-
array$extra optional Extra parameters
Returns
intshiftArgs() ¶ public
shiftArgs(): mixedRemoves first argument and shifts other arguments up
Returns
mixedversion() ¶ public
version(): voidPrints the currently installed version of CakePHP. Performs an internal dispatch to the CommandList Shell
Returns
void