Класс CommandRunner
Выполнение команд CLI для предоставленного приложения.
- Cake\Console\CommandRunner реализует Cake\Event\EventDispatcherInterface использует Cake\Event\EventDispatcherTrait
Краткое описание свойств
-
$aliasesprotectedСопоставления псевдонимов.array - Приложение, для которого выполняются консольные команды.
$appprotected - Приложение, для которого выполняются консольные команды.
$factoryprotected -
$rootprotectedИмя корневой команды. По умолчаниюstringcake.
Наследованные свойства
Краткое описание методов
- __construct() publicКонструктор
- bootstrap() protectedОбёртка для загрузки приложения.
- Проверка созданной коллекции команд
- createShell() protectedОбёртка для создания экземпляров оболочки.
- Получение/установка менеджера событий приложения.
- getEventManager() publicПолучение менеджера событий приложения или глобального.
- getShell() protectedПолучение экземпляра оболочки для заданного имени команды
- loadRoutes() protectedОбеспечение загрузки маршрутов приложения.
- resolveName() protectedПреобразование имени команды в существующее в коллекции.
- run() publicВыполнение команды, содержащейся в $argv.
- runShell() protectedВыполнение класса оболочки.
- setAliases() publicЗамена всего отображения псевдонимов для исполнителя.
- setEventManager() publicПолучение/установка менеджера событий приложения.
Подробное описание методов
__construct()source public
__construct( Cake\Core\ConsoleApplicationInterface $app , string $root = 'cake' , Cake\Console\CommandFactoryInterface $factory = null )
Конструктор
Параметры
-
Cake\Core\ConsoleApplicationInterface$app - Приложение для запуска команд CLI.
- string
$rootнеобязательно 'cake' - Имя корневой команды, которое нужно удалить из argv.
-
Cake\Console\CommandFactoryInterface$factoryнеобязательно null - Экземпляр фабрики команд.
bootstrap()source protected
bootstrap( )
Обёртка для загрузки приложения.
Вызывает bootstrap() и events() если приложение реализует EventApplicationInterface. После загрузки приложения и привязки событий, плагины загружаются и к ним привязываются события.
checkCollection()source protected deprecated
checkCollection( mixed $commands , string $method )
Проверка созданной коллекции команд
Устарело
3.6.0 Этот метод следует заменить типами возвращаемых значений в 4.xПараметры
- mixed
$commands - Коллекция команд для проверки, может быть чем угодно.
- string
$method - Метод, который использовался.
Исключения
RuntimeExceptioncreateShell()source protected
createShell( string $className , Cake\Console\ConsoleIo $io )
Обёртка для создания экземпляров оболочки.
Параметры
- string
$className - Имя класса оболочки.
-
Cake\Console\ConsoleIo$io - Обёртка ввода-вывода для созданного класса оболочки.
Возвращает
Cake\Console\Shell|Cake\Console\CommandeventManager()source public deprecated
eventManager( Cake\Event\EventManager $events = null )
Получить/установить менеджер событий приложения.
Если приложение не поддерживает события, и этот метод используется в качестве установщика, будет выброшено исключение.
Устарело
3.6.0 Будет удален в 4.0Параметры
-
Cake\Event\EventManager$eventsнеобязательно null - Менеджер событий для установки.
Возвращает
Cake\Event\EventManager|Cake\Console\CommandRunner$this
Реализация
Cake\Event\EventDispatcherInterface::eventManager() getEventManager()source public
getEventManager( )
Получить менеджер событий приложения или глобальный менеджер.
Возвращает
Cake\Event\EventManagerInterfacegetShell()source protected
getShell( Cake\Console\ConsoleIo $io , Cake\Console\CommandCollection $commands , string $name )
Получить экземпляр оболочки для заданного имени команды
Параметры
-
Cake\Console\ConsoleIo$io - Обёртка ввода-вывода для созданного класса оболочки.
-
Cake\Console\CommandCollection$commands - Коллекция команд для поиска оболочки.
- string
$name - Имя команды для поиска.
Возвращает
Cake\Console\Shell|Cake\Console\CommandloadRoutes()source protected
loadRoutes( )
Убедиться, что маршруты приложения загружены.
Команды консоли и оболочки часто нуждаются в генерации URL.
resolveName()source protected
resolveName( Cake\Console\CommandCollection $commands , Cake\Console\ConsoleIo $io , string $name )
Разрешить имя команды на имя, которое существует в коллекции.
Применить обратную совместимость с изгибами и псевдонимами.
Параметры
-
Cake\Console\CommandCollection$commands - Коллекция команд для проверки.
-
Cake\Console\ConsoleIo$io - Объект ConsoleIo для ошибок.
- string
$name - Имя из аргументов CLI.
Возвращает
stringРазрешённое имя.
run()source public
run( array $argv , Cake\Console\ConsoleIo $io = null )
Запустить команду, содержащуюся в $argv.
Используйте приложение для следующих действий:
- Загрузите приложение
- Создайте CommandCollection, используя метод console() приложения.
- Вызовите событие
Console.buildCommandsавтоподключения плагинов. - Запустите запрошенную команду.
Параметры
- array
$argv - Аргументы из среды CLI.
-
Cake\Console\ConsoleIo$ioнеобязательно null - Экземпляр ConsoleIo. Используется в основном для тестирования.
Возвращает
integerКод завершения команды.
Исключения
RuntimeExceptionrunShell()source protected
runShell( Cake\Console\Shell $shell , array $argv )
Выполнить класс Shell.
Параметры
-
Cake\Console\Shell$shell - Запускаемый shell.
- массив
$argv - Аргументы командной строки для вызова.
Возвращает
целое числоКод выхода
setAliases()source public
setAliases( array $aliases )
Заменить весь массив псевдонимов для исполнителя.
Псевдонимы позволяют определить альтернативные имена команд в коллекции. Это может быть полезно для добавления глобальных ключей, таких как --version или -h
Использование
$runner->setAliases(['--version' => 'version']);
Параметры
- массив
$aliases - Карта псевдонимов для замены.
Возвращает
$this
setEventManager()source public
setEventManager( Cake\Event\EventManager $events )
Получение/установка менеджера событий приложения.
Если приложение не поддерживает события, и этот метод используется в качестве установщика, будет выброшено исключение.
Параметры
-
Cake\Event\EventManager$events - Менеджер событий для установки.
Возвращает
$this
Методы, используемые из Cake\Event\EventDispatcherTrait
dispatchEvent()source public
dispatchEvent( string $name , array|null $data = null , object|null $subject = null )
Оборачивание для создания и отправки событий.
Возвращает отправленное событие.
Параметры
- строка
$name - Имя события.
- массив|null
$dataнеобязательно null Любое значение, которое вы хотите передать вместе с этим событием, чтобы его могли прочитать слушатели.
- объект|null
$subjectнеобязательно null Объект, к которому относится это событие ($this по умолчанию).
Возвращает
Cake\Event\EventМагические методы, унаследованные от Cake\Event\EventDispatcherInterface
getEventManager() |
Подробное описание свойств
$appsource
protected Cake\Core\ConsoleApplicationInterface
Консольное приложение, для которого выполняются команды.
$factorysource
protected Cake\Console\CommandFactoryInterface
Консольное приложение, для которого выполняются команды.
© 2005–present The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
https://api.cakephp.org/3.6/class-Cake.Console.CommandRunner.html