HelpCommand
class HelpCommand extends Command
HelpCommand отображает справку для заданной команды.
Методы
| static string|null | getDefaultName() | from Command |
| __construct(string|null $name = null) | from Command | |
| ignoreValidationErrors() Игнорирует ошибки валидации. | from Command | |
| setApplication(Application $application = null) | from Command | |
| setHelperSet(HelperSet $helperSet) | from Command | |
| HelperSet | getHelperSet() Возвращает набор помощников. | from Command |
| Application | getApplication() Возвращает экземпляр приложения для этой команды. | from Command |
| bool | isEnabled() Проверяет, включена ли команда в текущей среде. | from Command |
| int | run(InputInterface $input, OutputInterface $output) Выполняет команду. | from Command |
| $this | setCode(callable $code) Устанавливает код для выполнения при запуске этой команды. | from Command |
| mergeApplicationDefinition(bool $mergeArgs = true) Объединяет определение приложения с определением команды. | from Command | |
| $this | setDefinition(array|InputDefinition $definition) Устанавливает массив экземпляров аргументов и опций. | from Command |
| InputDefinition | getDefinition() Возвращает InputDefinition, прикреплённый к этой команде. | from Command |
| InputDefinition | getNativeDefinition() Возвращает InputDefinition, используемый для создания представлений этой команды. | from Command |
| $this | addArgument(string $name, int $mode = null, string $description = '', mixed $default = null) Добавляет аргумент. | from Command |
| $this | addOption(string $name, string $shortcut = null, int $mode = null, string $description = '', mixed $default = null) Добавляет опцию. | from Command |
| $this | setName(string $name) Устанавливает имя команды. | from Command |
| $this | setProcessTitle(string $title) Устанавливает заголовок процесса команды. | from Command |
| string | getName() Возвращает имя команды. | from Command |
| Command | setHidden(bool $hidden) | from Command |
| bool | isHidden() | from Command |
| $this | setDescription(string $description) Устанавливает описание для команды. | from Command |
| string | getDescription() Возвращает описание для команды. | from Command |
| $this | setHelp(string $help) Устанавливает справку для команды. | from Command |
| string | getHelp() Возвращает справку для команды. | from Command |
| string | getProcessedHelp() Возвращает обработанную справку для команды, динамически заменяя шаблоны %command.name% и %command.full_name% на реальные значения. | from Command |
| $this | setAliases(string[] $aliases) Устанавливает псевдонимы для команды. | from Command |
| array | getAliases() Возвращает псевдонимы для команды. | from Command |
| string | getSynopsis(bool $short = false) Возвращает краткое описание команды. | from Command |
| $this | addUsage(string $usage) Добавляет пример использования команды. | from Command |
| array | getUsages() Возвращает альтернативные способы использования команды. | from Command |
| mixed | getHelper(string $name) Возвращает экземпляр помощника по имени. | from Command |
| setCommand(Command $command) |
Подробное описание
static string|null getDefaultName()
Возвращаемое значение
| string|null | Имя команды по умолчанию или null, если имя по умолчанию не задано |
__construct(string|null $name = null)
Параметры
| string|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 |
int run(InputInterface $input, OutputInterface $output)
Выполняет команду.
Код для выполнения либо определён непосредственно методом setCode(), либо переопределён методом execute() в подклассе.
Параметры
| InputInterface | $input | |
| OutputInterface | $output |
Возвращаемое значение
| int | Код завершения команды |
Исключения
| Exception | При сбое привязки входных данных. Пропустите это, вызвав {@link ignoreValidationErrors()}. |
См. также
| setCode() | |
| execute() |
$this setCode(callable $code)
Устанавливает код для выполнения при запуске этой команды.
Если этот метод используется, он переопределяет код, определённый в методе execute().
Параметры
| callable | $code | Вызов callable(InputInterface $input, OutputInterface $output) |
Возвращаемое значение
| $this |
Исключения
| InvalidArgumentException |
См. также
| execute() |
mergeApplicationDefinition(bool $mergeArgs = true)
Объединяет определение приложения с определением команды.
Этот метод не является частью публичного API и не должен использоваться напрямую.
Параметры
| bool | $mergeArgs | Объединять или нет аргументы определения Application с аргументами определения Command |
$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 $mode = null, string $description = '', mixed $default = null)
Добавляет аргумент.
Параметры
| string | $name | Имя аргумента |
| int | $mode | Режим аргумента: InputArgument::REQUIRED или InputArgument::OPTIONAL |
| string | $description | Текст описания |
| mixed | $default | Значение по умолчанию (только для режима InputArgument::OPTIONAL) |
Возвращаемое значение
| $this |
$this 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) |
Возвращаемое значение
| $this |
$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 | Массив псевдонимов для команды |
Значение возврата
| $this |
Исключения
| 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 | если помощник не определен |
setCommand(Command $command)
Параметры
| Command | $command |
© 2004–2017 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/3.4/Symfony/Component/Console/Command/HelpCommand.html