AbstractCommand

Base command class for a Joomla! command line application.

abstract
since

2.0.0

package

Joomla Framework

Methods

__construct

Command constructor.

__construct(string|null name = null) : 
since

2.0.0

Arguments

name

string|nullThe name of the command; if the name is empty and no default is set, a name must be set in the configure() method

Response

mixed

addArgument

Adds an argument to the input definition.

addArgument( name, int mode = null,  description = '',  default = null) : 
since

2.0.0

Arguments

name

stringThe argument name

mode

int|nullThe argument mode: InputArgument::REQUIRED or InputArgument::OPTIONAL

description

stringA description text

default

mixedThe default value (for InputArgument::OPTIONAL mode only)

Response

$this

addOption

Adds an option to the input definition.

addOption( name, string|array shortcut = null, int mode = null,  description = '', mixed default = null) : 
since

2.0.0

Arguments

name

stringThe option name

shortcut

string|array<string|int, mixed>The shortcuts, can be null, a string of shortcuts delimited by | or an array of shortcuts

mode

int|nullThe option mode: One of the VALUE_* constants

description

stringA description text

default

mixed|nullThe default value (must be null for InputOption::VALUE_NONE)

Response

$this

configure

Configure the command.

configure() : 
since

2.0.0

Response

void

doExecute

Internal function to execute the command.

doExecute(\Symfony\Component\Console\Input\InputInterface input, \Symfony\Component\Console\Output\OutputInterface output) : 
abstract
since

2.0.0

Arguments

input

InputInterfaceThe input to inject into the command.

output

OutputInterfaceThe output to inject into the command.

Response

intThe command exit code

execute

Executes the command.

execute(\Symfony\Component\Console\Input\InputInterface input, \Symfony\Component\Console\Output\OutputInterface output) : 
since

2.0.0

Arguments

input

InputInterfaceThe input to inject into the command.

output

OutputInterfaceThe output to inject into the command.

Response

intThe command exit code

getAliases

Get the command's aliases.

getAliases() : string||string|int
since

2.0.0

Response

array<string|int, string>

getApplication

Get the application object.

getApplication() : \Joomla\Console\Application
since

2.0.0

throws

UnexpectedValueExceptionif the application has not been set.

Response

ApplicationThe application object.

getDefaultName

Get the default command name for this class.

getDefaultName() : string|null
static

This allows a command name to defined and referenced without instantiating the full command class.

since

2.0.0

Response

string|null

getDefinition

Gets the InputDefinition attached to this command.

getDefinition() : \Symfony\Component\Console\Input\InputDefinition
since

2.0.0

Response

InputDefinition

getDescription

Get the command's description.

getDescription() : 
since

2.0.0

Response

string

getHelp

Get the command's help.

getHelp() : 
since

2.0.0

Response

string

getHelperSet

Get the command's input helper set.

getHelperSet() : \Symfony\Component\Console\Helper\HelperSet|null
since

2.0.0

Response

HelperSet|null

getName

Get the command's name.

getName() : string|null
since

2.0.0

Response

string|null

getProcessedHelp

Returns the processed help for the command.

getProcessedHelp() : 

This method is used to replace placeholders in commands with the real values. By default, this supports %command.name% and %command.full_name.

since

2.0.0

Response

string

getSynopsis

Get the command's synopsis.

getSynopsis( short = false) : 
since

2.0.0

Arguments

short

boolFlag indicating whether the short or long version of the synopsis should be returned

Response

string

initialise

Internal hook to initialise the command after the input has been bound and before the input is validated.

initialise(\Symfony\Component\Console\Input\InputInterface input, \Symfony\Component\Console\Output\OutputInterface output) : 
since

2.0.0

Arguments

input

InputInterfaceThe input to inject into the command.

output

OutputInterfaceThe output to inject into the command.

Response

void

isEnabled

Check if the command is enabled in this environment.

isEnabled() : 
since

2.0.0

Response

bool

isHidden

Check if the command is hidden from the command listing.

isHidden() : 
since

2.0.0

Response

bool

setAliases

Set the command's aliases.

setAliases(string||string|int aliases) : 
since

2.0.0

Arguments

aliases

array<string|int, string>The command aliases

Response

void

setApplication

Set the command's application.

setApplication(\Joomla\Console\Application application = null) : 
since

2.0.0

Arguments

application

Application|nullThe command's application

Response

void

setDefinition

Sets the input definition for the command.

setDefinition(array|\Symfony\Component\Console\Input\InputDefinition definition) : 
since

2.0.0

Arguments

definition

array<string|int, mixed>|InputDefinitionEither an InputDefinition object or an array of objects to write to the definition.

Response

void

setDescription

Sets the description for the command.

setDescription( description) : 
since

2.0.0

Arguments

description

stringThe description for the command

Response

void

setHelp

Sets the help for the command.

setHelp( help) : 
since

2.0.0

Arguments

help

stringThe help for the command

Response

void

setHelperSet

Set the command's input helper set.

setHelperSet(\Symfony\Component\Console\Helper\HelperSet helperSet) : 
since

2.0.0

Arguments

helperSet

HelperSetThe helper set.

Response

void

setHidden

Set whether this command is hidden from the command listing.

setHidden( hidden) : 
since

2.0.0

Arguments

hidden

boolFlag if this command is hidden.

Response

void

setName

Set the command's name.

setName( name) : 
since

2.0.0

Arguments

name

stringThe command name

Response

void

Properties

defaultName

The default command name

static
since

2.0.0

Type(s)

string|null

aliases

The command's aliases.

since

2.0.0

Type(s)

array<string|int, string>

application

The application running this command.

since

2.0.0

Type(s)

Application|null

applicationDefinitionMerged

Flag tracking whether the application definition has been merged to this command.

since

2.0.0

Type(s)

bool

applicationDefinitionMergedWithArgs

Flag tracking whether the application definition with arguments has been merged to this command.

since

2.0.0

Type(s)

bool

definition

The command's input definition.

since

2.0.0

Type(s)

InputDefinition

description

The command's description.

since

2.0.0

Type(s)

string

help

The command's help.

since

2.0.0

Type(s)

string

helperSet

The command's input helper set.

since

2.0.0

Type(s)

HelperSet|null

hidden

Flag tracking whether the command is hidden from the command listing.

since

2.0.0

Type(s)

bool

name

The command's name.

since

2.0.0

Type(s)

string

synopsis

The command's synopses.

since

2.0.0

Type(s)

array<string|int, string>