AbstractConfigCommand

static строка|null getDefaultName()

Значение возвращаемого результата

строка|null

Имя команды по умолчанию или null, если имя по умолчанию не задано

__construct(строка $name = null)

Параметры

строка

$name

Имя команды; передача null означает, что оно должно быть установлено в configure()

Исключения

LogicException

Когда имя команды пустое

ignoreValidationErrors()

Игнорирует ошибки валидации.

Это полезно, главным образом, для команды help.

setApplication(Application $application = null)

Параметры

Application

$application

setHelperSet(HelperSet $helperSet)

Параметры

HelperSet

$helperSet

HelperSet getHelperSet()

Получает набор помощников.

Значение возвращаемого результата

HelperSet

Экземпляр HelperSet

Application getApplication()

Получает экземпляр приложения для этой команды.

Значение возвращаемого результата

Application

Экземпляр Application

bool isEnabled()

Проверяет, включена ли команда в текущей среде.

Переопределите этот метод, чтобы проверить x или y и вернуть false, если команда не может работать должным образом в текущих условиях.

Значение возвращаемого результата

bool

protected configure()

Настраивает текущую команду.

protected int|null execute(InputInterface $input, OutputInterface $output)

Выполняет текущую команду.

Этот метод не является абстрактным, потому что вы можете использовать этот класс как конкретный класс. В этом случае, вместо определения метода execute(), вы устанавливаете код для выполнения, передавая Closure в метод setCode().

Параметры

InputInterface	$input
OutputInterface	$output

Значение возвращаемого результата

int|null

null или 0, если всё прошло хорошо, или код ошибки

Исключения

LogicException

Когда этот абстрактный метод не реализован

protected interact(InputInterface $input, OutputInterface $output)

Взаимодействует с пользователем.

Этот метод выполняется до проверки InputDefinition. Это означает, что это единственное место, где команда может интерактивно запросить значения отсутствующих обязательных аргументов.

Параметры

InputInterface	$input
OutputInterface	$output

protected initialize(InputInterface $input, OutputInterface $output)

Инициализирует команду после привязки входных данных и перед валидацией входных данных.

Это полезно, главным образом, когда много команд расширяют одну основную команду, где некоторые вещи должны быть инициализированы на основе входных аргументов и опций.

Параметры

InputInterface	$input
OutputInterface	$output

См. также

InputInterface::bind
InputInterface::validate

int run(InputInterface $input, OutputInterface $output)

Выполняет команду.

Код для выполнения определяется либо непосредственно с помощью метода setCode(), либо путём переопределения метода execute() в подклассе.

Параметры

InputInterface	$input
OutputInterface	$output

Значение возвращаемого результата

int	Код завершения команды

Исключения

Исключение

При сбое привязки входных данных. Обойдите это, вызвав {@link ignoreValidationErrors()}.

См. также

setCode()
execute()

$this setCode(callable $code)

Устанавливает код для выполнения при запуске этой команды.

Если используется этот метод, он переопределяет код, определённый в методе execute().

Параметры

callable

$code

A callable(InputInterface $input, OutputInterface $output)

Значение возвращаемого результата

$this

Исключения

InvalidArgumentException

См. также

execute()

mergeApplicationDefinition(bool $mergeArgs = true)

Объединяет определение приложения с определением команды.

Этот метод не является частью публичного API и не должен использоваться напрямую.

Параметры

bool

$mergeArgs

Объединять или нет аргументы определения приложения с аргументами определения команды

$this setDefinition(array|InputDefinition $definition)

Устанавливает массив экземпляров аргументов и опций.

Параметры

array|InputDefinition

$definition

Массив экземпляров аргументов и опций или экземпляр определения

Значение возвращаемого результата

$this

InputDefinition getDefinition()

Получает InputDefinition, присоединённую к этой команде.

Значение возвращаемого результата

InputDefinition

Экземпляр InputDefinition

InputDefinition getNativeDefinition()

Получает InputDefinition, используемую для создания представлений этой команды.

Может быть переопределён, чтобы предоставить исходное представление команды, когда в противном случае оно будет изменено путём объединения с InputDefinition приложения.

Этот метод не является частью публичного API и не должен использоваться напрямую.

Значение возвращаемого значения

InputDefinition

Экземпляр InputDefinition

$this addArgument(string $name, int|null $mode = null, string $description = '', string|string[]|null $default = null)

Добавляет аргумент.

Параметры

string	$name	Имя аргумента
int|null	$mode	Режим аргумента: self::REQUIRED или self::OPTIONAL
string	$description	Текст описания
string|string[]|null	$default	Значение по умолчанию (только для режима self::OPTIONAL)

Значение возвращаемого значения

$this

Исключения

InvalidArgumentException

При некорректном режиме аргумента

$this addOption(string $name, string|array $shortcut = null, int|null $mode = null, string $description = '', string|string[]|bool|null $default = null)

Добавляет опцию.

Параметры

string	$name	Имя опции
string|array	$shortcut	Сокращения, могут быть null, строкой сокращений, разделенных |, или массивом сокращений
int|null	$mode	Режим опции: Один из констант VALUE_*
string	$description	Текст описания
string|string[]|bool|null	$default	Значение по умолчанию (должно быть null для self::VALUE_NONE)

Значение возвращаемого значения

$this

Исключения

InvalidArgumentException

Если режим опции некорректен или несовместим

$this setName(string $name)

Устанавливает имя команды.

Этот метод может установить как имя, так и пространство имён, если вы разделяете их двоеточием (:)

$command->setName('foo:bar');

Параметры

string

$name

Имя команды

Значение возвращаемого значения

$this

Исключения

InvalidArgumentException

Если имя некорректно

$this setProcessTitle(string $title)

Устанавливает заголовок процесса команды.

Эта функция должна использоваться только при создании команды с длительным процессом, например, демона.

Требуется PHP 5.5+ или библиотека proctitle PECL.

Параметры

string

$title

Заголовок процесса

Значение возвращаемого значения

$this

string getName()

Возвращает имя команды.

Значение возвращаемого значения

string

Имя команды

Command setHidden(bool $hidden)

Параметры

bool

$hidden

Скрывать ли команду из списка команд

Значение возвращаемого значения

Command

Текущий экземпляр

bool isHidden()

Значение возвращаемого значения

bool	Скрывать ли команду

$this setDescription(string $description)

Устанавливает описание для команды.

Параметры

string

$description

Описание команды

Значение возвращаемого значения

$this

string getDescription()

Возвращает описание команды.

Значение возвращаемого значения

string

Описание команды

$this setHelp(string $help)

Устанавливает справку для команды.

Параметры

string

$help

Справка для команды

Значение возвращаемого значения

$this

string getHelp()

Возвращает справку для команды.

Значение возвращаемого значения

string

Справка для команды

string getProcessedHelp()

Возвращает обработанную справку для команды, динамически заменяя шаблоны %command.name% и %command.full_name% на реальные значения.

Значение возвращаемого значения

string

Обработанная справка для команды

$this setAliases(string[] $aliases)

Устанавливает псевдонимы для команды.

Параметры

string[]

$aliases

Массив псевдонимов для команды

Исключения

InvalidArgumentException

При некорректном псевдониме

array getAliases()

Возвращает псевдонимы для команды.

Значение возвращаемого значения

array

Массив псевдонимов для команды

string getSynopsis(bool $short = false)

Возвращает краткое описание команды.

Параметры

bool

$short

Показывать ли краткую версию описания (с опциями сложенными)

Значение возвращаемого значения

string

Описание

$this addUsage(string $usage)

Добавляет пример использования команды.

Параметры

string

$usage

Использование, будет добавлено префиксом имени команды

Значение возвращаемого значения

$this

array getUsages()

Возвращает альтернативные способы использования команды.

Значение возвращаемого значения

array

mixed getHelper(string $name)

Получает экземпляр помощника по имени.

Параметры

string

$name

Имя помощника

Значение возвращаемого значения

mixed

Значение помощника

Исключения

LogicException	Если HelperSet не определён
InvalidArgumentException	Если помощник не определён

protected validateInput(InputInterface $input)

Проверяет входные аргументы и опции.

Параметры

InputInterface

$input

Исключения

InvalidArgumentException

protected ContainerBuilder getContainerBuilder()

Загружает ContainerBuilder из кэша.

Значение возвращаемого значения

ContainerBuilder

Исключения

LogicException

filterToServiceTypes($serviceId)

Параметры

$serviceId

protected listBundles($output)

Параметры

$output

protected findExtension($name)

Параметры

$name

validateConfiguration(ExtensionInterface $extension, $configuration)

Параметры

ExtensionInterface	$extension
	$configuration