Приложение
класс Application
Приложение — контейнер для набора команд.
Это главная точка входа консольного приложения.
Этот класс оптимизирован для стандартной среды CLI.
Использование:
$app = new Application('myapp', '1.0 (stable)');
$app->add(new SimpleCommand());
$app->run();
Методы
| __construct(string $name = 'UNKNOWN', string $version = 'UNKNOWN') | ||
| setDispatcher(EventDispatcherInterface $dispatcher) | ||
| setCommandLoader(CommandLoaderInterface $commandLoader) | ||
| int | run(InputInterface $input = null, OutputInterface $output = null) Запускает текущее приложение. | |
| int | doRun(InputInterface $input, OutputInterface $output) Запускает текущее приложение. | |
| setHelperSet(HelperSet $helperSet) | ||
| HelperSet | getHelperSet() Получить набор помощников, связанных с командой. | |
| setDefinition(InputDefinition $definition) | ||
| InputDefinition | getDefinition() Получить InputDefinition, связанный с этим приложением. | |
| string | getHelp() Получить сообщение справки. | |
| bool | areExceptionsCaught() Получить, перехватываются ли исключения во время выполнения команд. | |
| setCatchExceptions(bool $boolean) Установить, перехватываются ли исключения во время выполнения команд. | ||
| bool | isAutoExitEnabled() Получить, автоматически ли происходит выход после выполнения команды. | |
| setAutoExit(bool $boolean) Установить, автоматически ли происходит выход после выполнения команды. | ||
| string | getName() Получить имя приложения. | |
| setName(string $name) Установить имя приложения. | ||
| string | getVersion() Получить версию приложения. | |
| setVersion(string $version) Установить версию приложения. | ||
| string | getLongVersion() Возвращает полную версию приложения. | |
| Command | register(string $name) Регистрирует новую команду. | |
| addCommands(array $commands) Добавляет массив объектов команд. | ||
| Command|null | add(Command $command) Добавляет объект команды. | |
| Command | get(string $name) Возвращает зарегистрированную команду по имени или псевдониму. | |
| bool | has(string $name) Возвращает true, если команда существует, в противном случае — false. | |
| string[] | getNamespaces() Возвращает массив всех уникальных пространств имен, используемых текущими зарегистрированными командами. | |
| string | findNamespace(string $namespace) Ищет зарегистрированное пространство имен по имени или сокращению. | |
| Command | find(string $name) Ищет команду по имени или псевдониму. | |
| Command[] | all(string $namespace = null) Получить команды (зарегистрированные в указанном пространстве имен, если предоставлено). | |
| static array | getAbbreviations(array $names) Возвращает массив возможных сокращений, заданных набором имен. | |
| renderException(Exception $e, OutputInterface $output) Отображает перехваченное исключение. | ||
| array | getTerminalDimensions() deprecated Пытается определить размеры терминала на основе текущей среды. | |
| $this | setTerminalDimensions(int $width, int $height) deprecated Устанавливает размеры терминала. | |
| string | extractNamespace(string $name, string $limit = null) Возвращает часть пространства имен имени команды. | |
| Application | setDefaultCommand(string $commandName, bool $isSingleCommand = false) Устанавливает имя команды по умолчанию. |
Подробности
__construct(string $name = 'UNKNOWN', string $version = 'UNKNOWN')
Параметры
| string | $name | Имя приложения |
| string | $version | Версия приложения |
setDispatcher(EventDispatcherInterface $dispatcher)
Параметры
| EventDispatcherInterface | $dispatcher |
setCommandLoader(CommandLoaderInterface $commandLoader)
Параметры
| CommandLoaderInterface | $commandLoader |
int run(InputInterface $input = null, OutputInterface $output = null)
Выполняет текущее приложение.
Параметры
| InputInterface | $input | |
| OutputInterface | $output |
Возвращаемое значение
| int | 0, если всё прошло хорошо, или код ошибки |
Исключения
| Exception | При возникновении ошибки во время выполнения. Можно пропустить это, если {@link setCatchExceptions()}. |
int doRun(InputInterface $input, OutputInterface $output)
Выполняет текущее приложение.
Параметры
| InputInterface | $input | |
| OutputInterface | $output |
Возвращаемое значение
| int | 0, если всё прошло хорошо, или код ошибки |
setHelperSet(HelperSet $helperSet)
Параметры
| HelperSet | $helperSet |
HelperSet getHelperSet()
Получить набор помощников, связанный с командой.
Возвращаемое значение
| HelperSet | Экземпляр HelperSet, связанный с этой командой |
setDefinition(InputDefinition $definition)
Параметры
| InputDefinition | $definition |
InputDefinition getDefinition()
Получение InputDefinition, связанной с этим приложением.
Возвращаемое значение
| InputDefinition | Экземпляр InputDefinition |
string getHelp()
Получить сообщение справки.
Возвращаемое значение
| string | Сообщение справки |
bool areExceptionsCaught()
Получить, нужно ли перехватывать исключения при выполнении команд.
Возвращаемое значение
| bool | Перехватывать исключения или нет при выполнении команд |
setCatchExceptions(bool $boolean)
Установить, нужно ли перехватывать исключения при выполнении команд.
Параметры
| bool | $boolean | Перехватывать исключения или нет при выполнении команд |
bool isAutoExitEnabled()
Получить, нужно ли автоматически завершать приложение после выполнения команды.
Возвращаемое значение
| bool | Автоматически завершать приложение после выполнения команды или нет |
setAutoExit(bool $boolean)
Установить, нужно ли автоматически завершать приложение после выполнения команды.
Параметры
| bool | $boolean | Автоматически завершать приложение после выполнения команды или нет |
string getName()
Получить имя приложения.
Возвращаемое значение
| string | Имя приложения |
setName(string $name)
Установить имя приложения.
Параметры
| string | $name | Имя приложения |
string getVersion()
Получить версию приложения.
Возвращаемое значение
| string | Версия приложения |
setVersion(string $version)
Установить версию приложения.
Параметры
| string | $version | Версия приложения |
string getLongVersion()
Возвращает полную версию приложения.
Возвращаемое значение
| string | Полная версия приложения |
Command register(string $name)
Регистрирует новую команду.
Параметры
| string | $name | Имя команды |
Возвращаемое значение
| Command | Созданная команда |
addCommands(array $commands)
Добавляет массив объектов команд.
Если команда не включена, она не будет добавлена.
Параметры
| array | $commands | Массив команд |
Command|null add(Command $command)
Добавляет объект команды.
Если команда с таким же именем уже существует, она будет перезаписана. Если команда не включена, она не будет добавлена.
Параметры
| Command | $command |
Возвращаемое значение
| Command|null | Зарегистрированная команда, если включена, или null |
Command get(string $name)
Возвращает зарегистрированную команду по имени или псевдониму.
Параметры
| string | $name | Имя или псевдоним команды |
Возвращаемое значение
| Command | Объект Command |
Исключения
| CommandNotFoundException | Если команды с данным именем не существует |
bool has(string $name)
Возвращает true, если команда существует, иначе false.
Параметры
| string | $name | Имя или псевдоним команды |
Возвращаемое значение
| bool | true, если команда существует, иначе false |
string[] getNamespaces()
Возвращает массив всех уникальных пространств имён, используемых текущими зарегистрированными командами.
Он не возвращает глобальное пространство имён, которое всегда существует.
Возвращаемое значение
| string[] | Массив пространств имён |
string findNamespace(string $namespace)
Находит зарегистрированное пространство имён по имени или сокращению.
Параметры
| string | $namespace | Пространство имён или сокращение для поиска |
Возвращаемое значение
| string | Зарегистрированное пространство имён |
Исключения
| CommandNotFoundException | При неверном или неоднозначном имени пространства имён |
Команда find(string $name)
Находит команду по имени или псевдониму.
В отличие от get, эта команда пытается найти наилучшее соответствие, если вы предоставляете сокращение имени или псевдонима.
Параметры
| string | $name | Имя команды или псевдоним команды |
Возвращаемое значение
| Команда | Экземпляр Command |
Исключения
| CommandNotFoundException | При неверном или неоднозначном имени команды |
Command[] all(string $namespace = null)
Получает команды (зарегистрированные в указанном пространстве имён, если оно предоставлено).
Ключами массива являются полные имена, а значениями — экземпляры команд.
Параметры
| string | $namespace | Имя пространства имён |
Возвращаемое значение
| Command[] | Массив экземпляров Command |
static array getAbbreviations(array $names)
Возвращает массив возможных сокращений, заданных набором имён.
Параметры
| array | $names | Массив имён |
Возвращаемое значение
| array | Массив сокращений |
renderException(Exception $e, OutputInterface $output)
Отображает пойманное исключение.
Параметры
| Exception | $e | |
| OutputInterface | $output |
array getTerminalDimensions() устаревшее
устаревшее
Пытается определить размеры терминала на основе текущей среды.
Возвращаемое значение
| array | Массив, содержащий ширину и высоту |
$this setTerminalDimensions(int $width, int $height) устаревшее
устаревшее
Устанавливает размеры терминала.
Может быть полезно принудительно установить размеры терминала для функциональных тестов.
Параметры
| int | $width | Ширина |
| int | $height | Высота |
Возвращаемое значение
| $this |
string extractNamespace(string $name, string $limit = null)
Возвращает часть пространства имён имени команды.
Этот метод не входит в общедоступный API и не должен использоваться напрямую.
Параметры
| string | $name | Полное имя команды |
| string | $limit | Максимальное количество частей пространства имён |
Возвращаемое значение
| string | Пространство имён команды |
Приложение setDefaultCommand(string $commandName, bool $isSingleCommand = false)
Устанавливает имя команды по умолчанию.
Параметры
| string | $commandName | Имя команды |
| bool | $isSingleCommand | Установите в true, если в этом приложении только одна команда |
Возвращаемое значение
| Приложение |
© 2004–2017 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/3.4/Symfony/Component/Console/Application.html