ServerCommand
class ServerCommand extends ContainerAwareCommand
Базовые методы для команд, связанных с встроенным веб-сервером PHP.
Методы
| __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() Проверяет, включена ли команда в текущей среде. | |
| 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 |
| setContainer(ContainerInterface $container = null) Устанавливает контейнер. | from ContainerAwareCommand |
Подробности
__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 | Код завершения команды |
См. также
| 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, прикреплённый к этому Command.
Значение возврата
| 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 | если помощник не определён |
setContainer(ContainerInterface $container = null)
Устанавливает контейнер.
Параметры
| ContainerInterface | $container | Экземпляр ContainerInterface или null |
© 2004–2017 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/3.4/Symfony/Bundle/FrameworkBundle/Command/ServerCommand.html