RouterDebugCommand

__construct(string|null $name = null)

Конструктор.

Параметры

string|null

$name

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

Исключения

LogicException

При пустом имени команды

ignoreValidationErrors()

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

Это в основном полезно для команды help.

setApplication(Application $application = null)

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

Параметры

Application

$application

Экземпляр Application

setHelperSet(HelperSet $helperSet)

Устанавливает набор помощников.

Параметры

HelperSet

$helperSet

Экземпляр HelperSet

HelperSet getHelperSet()

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

Значение возврата

HelperSet

Экземпляр HelperSet

Application getApplication()

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

Значение возврата

Application

Экземпляр Application

bool isEnabled()

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

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

Значение возврата

bool

int run(InputInterface $input, OutputInterface $output)

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

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

Параметры

InputInterface	$input	Экземпляр InputInterface
OutputInterface	$output	Экземпляр OutputInterface

Значение возврата

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

Исключения

Exception

См. также

setCode()
execute()

Command setCode(callable $code)

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

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

Параметры

callable

$code

callable(InputInterface $input, OutputInterface $output)

Значение возврата

Command

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

Исключения

InvalidArgumentException

См. также

execute()

mergeApplicationDefinition(bool $mergeArgs = true)

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

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

Параметры

bool

$mergeArgs

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

Command setDefinition(array|InputDefinition $definition)

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

Параметры

array|InputDefinition

$definition

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

Значение возврата

Command

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

InputDefinition getDefinition()

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

Значение возврата

InputDefinition

Экземпляр InputDefinition

InputDefinition getNativeDefinition()

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

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

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

Значение возврата

InputDefinition

Экземпляр InputDefinition

Command addArgument(string $name, int $mode = null, string $description = '', mixed $default = null)

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

Параметры

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

Значение возврата

Command

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

Command addOption(string $name, string $shortcut = null, int $mode = null, string $description = '', mixed $default = null)

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

Параметры

string	$name	Имя опции
string	$shortcut	Сокращение (может быть null)
int	$mode	Режим опции: Один из констант InputOption::VALUE_*
string	$description	Текст описания
mixed	$default	Значение по умолчанию (должно быть null для InputOption::VALUE_NONE)

Значение возврата

Command

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

Command setName(string $name)

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

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

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

Параметры

string

$name

Имя команды

Значение возврата

Command

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

Исключения

InvalidArgumentException

При некорректном имени

Command setProcessTitle(string $title)

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

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

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

Параметры

string

$title

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

Возвращаемое значение

Команда

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

строка getName()

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

Возвращаемое значение

строка

Имя команды

Команда setDescription(строка $description)

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

Параметры

строка

$description

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

Возвращаемое значение

Команда

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

строка getDescription()

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

Возвращаемое значение

строка

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

Команда setHelp(строка $help)

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

Параметры

строка

$help

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

Возвращаемое значение

Команда

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

строка getHelp()

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

Возвращаемое значение

строка

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

строка getProcessedHelp()

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

Возвращаемое значение

строка

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

Команда setAliases(строка[] $aliases)

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

Параметры

строка[]

$aliases

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

Возвращаемое значение

Команда

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

Исключения

ИсключениеНекорректногоАргумента

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

массив getAliases()

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

Возвращаемое значение

массив

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

строка getSynopsis(bool $short = false)

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

Параметры

bool

$short

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

Возвращаемое значение

строка

Краткое описание

Команда addUsage(строка $usage)

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

Параметры

строка

$usage

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

Возвращаемое значение

Команда

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

массив getUsages()

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

Возвращаемое значение

массив

смешанный тип getHelper(строка $name)

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

Параметры

строка

$name

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

Возвращаемое значение

смешанный тип

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

Исключения

ЛогическоеИсключение	если не определен HelperSet
ИсключениеНекорректногоАргумента	если помощник не определен

строка asText() ^{устаревший}

^{устаревший}

since версия 2.3, будет удален в 3.0.

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

Возвращаемое значение

строка

Строка, представляющая команду

строка|DOMDocument asXml(bool $asDom = false) ^{устаревший}

^{устаревший}

since версия 2.3, будет удален в 3.0.

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

Параметры

bool

$asDom

Возвращать DOM или XML-строку

Возвращаемое значение

строка|DOMDocument

XML-строка, представляющая команду

setContainer(ИнтерфейсКонтейнера $container = null)

Устанавливает контейнер.

Параметры

ИнтерфейсКонтейнера

$container

Экземпляр ContainerInterface или null