Класс ShellDispatcher
ShellDispatcher обрабатывает диспетчеризацию команд CLI.
Обратитесь к /bin/cake.php, чтобы узнать, как этот класс используется на практике.
Краткое описание свойств
- Список подключённых псевдонимов.
array -
$argspublicСодержит аргументы, обработанные из командной строки.array
Краткое описание методов
- __construct() publicКонструктор
- _bootstrap() protectedИнициализирует среду и загружает ядро CakePHP.
- _createShell() protectedСоздаёт указанную оболочку и задаёт свойство плагина
- _dispatch() protectedДиспетчеризация запроса.
- _handleAlias() protectedЕсли вход соответствует псевдониму, возвращает имя оболочки с псевдонимом
- _initEnvironment() protectedОпределяет текущую рабочую среду.
- _shellExists() protectedПроверяет существование класса оболочки для данного имени.
- addShortPluginAliases() publicДля всех загруженных плагинов добавляет короткий псевдоним
- Добавляет псевдоним для команды оболочки.
- dispatch() publicДиспетчеризирует запрос CLI
- findShell() publicПолучение оболочки для использования, либо оболочка плагина, либо приложения
- help() publicОтображает справку консоли. Выполняет внутреннюю диспетчеризацию в оболочку CommandList
- Очищает установленные псевдонимы.
- Запуск диспетчера
- shiftArgs() publicУдаляет первый аргумент и сдвигает другие аргументы вверх
- version() publicВыводит текущую установленную версию CakePHP. Выполняет внутреннюю диспетчеризацию в оболочку CommandList
Подробное описание методов
__construct()source public
__construct( array $args [] , boolean $bootstrap true )
Конструктор
Выполнение скрипта останавливается после диспетчеризации запроса со статусом кода 0 или 1 в соответствии с результатом диспетчеризации.
Параметры
- массив
$argsопционально [] - argv из PHP
- логическое
$bootstrapопционально true - Нужно ли выполнить загрузку среды?
_bootstrap()source protected
_bootstrap( )
Инициализирует среду и загружает ядро CakePHP.
Возвращает
booleanУспех.
_createShell()source protected
_createShell( string $className , string $shortName )
Создаёт указанную оболочку и задаёт свойство плагина
Параметры
- строка
$className - Имя класса для создания экземпляра
- строка
$shortName - Имя оболочки с префиксом плагина
Возвращает
Cake\Console\ShellЭкземпляр оболочки.
_dispatch()source protected
_dispatch( array $extra [] )
Диспетчеризация запроса.
Параметры
- массив
$extraопционально [] Дополнительные параметры, которые вы можете вручную передать в оболочку для диспетчеризации. Встроенный дополнительный параметр: -
requested: если используется, предотвратит отображение приветственного сообщения оболочки.
Возвращает
booleanИсключения
Cake\Console\Exception\MissingShellMethodException_handleAlias()source protected
_handleAlias( string $shell )
Если вход соответствует псевдониму, возвращает имя оболочки с псевдонимом
Параметры
- строка
$shell - Опционально имя плагина или псевдонима
Возвращает
строкаИмя оболочки с префиксом плагина
_initEnvironment()source protected
_initEnvironment( )
Определяет текущую рабочую среду.
Исключения
Cake\Core\Exception\Exception_shellExists()source protected
_shellExists( string $shell )
Проверяет существование класса оболочки для данного имени.
Параметры
- строка
$shell - Имя оболочки для поиска.
Возвращает
строка|booleanИмя класса или false.
addShortPluginAliases()source public
addShortPluginAliases( )
Для всех загруженных плагинов добавляет короткий псевдоним
Это позволяет получить доступ к плагину, реализующему оболочку с тем же именем, используя только имя оболочки.
Возвращает
массиврезультирующий список псевдонимов
alias()source public static
alias( string $short , string|null $original null )
Добавляет псевдоним для команды оболочки.
Псевдонимы позволяют вызывать оболочки по альтернативным именам. Это наиболее полезно при работе с оболочками плагинов, для которых вы хотите установить более короткие имена.
Если вы используете псевдоним повторно, последний установленный псевдоним будет доступным.
Использование
Создание псевдонима для оболочки с именем ClassName:
$this->alias('alias', 'ClassName'); Получение исходного имени для заданного псевдонима:
$this->alias('alias'); Параметры
- строка
$short - Новое короткое имя оболочки.
- строка|null
$originalопционально null - Исходное полное имя оболочки.
Возвращает
строка|falseИмя алиасированного класса или false, если псевдонима не существует
dispatch()source public
dispatch( array $extra [] )
Диспетчеризирует запрос CLI
Преобразует результат команды оболочки в код выхода. Null/True рассматривается как успех. Все другие возвращаемые значения – ошибка.
Параметры
- массив
$extraопционально [] Дополнительные параметры, которые вы можете вручную передать в оболочку для диспетчеризации. Встроенный дополнительный параметр: -
requested: если используется, предотвратит отображение приветственного сообщения оболочки.
Возвращает
целое числоКод выхода команды CLI. 0 – успех.
findShell()source public
findShell( string $shell )
Получение оболочки для использования, либо оболочка плагина, либо приложения
Все пути в загруженных путях оболочки проверяются, обрабатывается дериференция псевдонимов
Параметры
- строка
$shell - Опционально имя плагина
Возвращает
Cake\Console\ShellЭкземпляр оболочки.
Исключения
Cake\Console\Exception\MissingShellExceptionв случае возникновения ошибок.
help()source public
help( )
Отображает справку консоли. Выполняет внутреннюю отправку в командный Shell CommandList
run()source public static
run( array $argv , array $extra [] )
Запуск диспетчера
Параметры
- массив
$argv - argv из PHP
- массив
$extraнеобязательно [] - Дополнительные параметры
Возвращаемое значение
целое числоКод завершения процесса командной оболочки.
shiftArgs()source public
shiftArgs( )
Удаляет первый аргумент и сдвигает остальные аргументы вверх
Возвращаемое значение
смешанный типNull, если аргументов нет, иначе сдвинутый аргумент
version()source public
version( )
Выводит текущую установленную версию CakePHP. Выполняет внутреннюю отправку в командный Shell CommandList
Подробности свойств
© 2005–2017 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.3/class-Cake.Console.ShellDispatcher.html