Использование конспольных команд, ярлыков и встроенных команд¶
В дополнение к опциям, которые вы указываете для ваших команд, существуют ещё встроенные опции, а также несколько встроенных команд для компонента Console.
Note
Эти примеры предполагают, что вы добавили файл application.php
для запуска
в cli:
#!/usr/bin/env php
<?php
// application.php
require __DIR__.'/vendor/autoload.php';
use Symfony\Component\Console\Application;
$application = new Application();
// ...
$application->run();
Встроенные команды¶
Суещствуется встроенная команда list
, которая выводит все стандартные опции
и зарегистрированные команды:
1 | $ php application.php list
|
Вы также можете получить такой же вывод, не запуская никаких команд
1 | $ php application.php
|
Команда помощи перечисляет информацию помощи для указанной команды. Например,
чтобы получить помощь по команде list
:
1 | $ php application.php help list
|
Запуск help
без указания команды перечислит глобальные опции:
1 | $ php application.php help
|
Глобальные опции¶
Вы можете получить информацию помощи для любой команды с помощью опции
--help
. Чтобы получить помощь по команде list:
1 2 | $ php application.php list --help
$ php application.php list -h
|
Вы можете подавить вывод с помощью:
1 2 | $ php application.php list --quiet
$ php application.php list -q
|
Вы можете получить более детализированные сообщения (если это поддерживается командой) с помощью:
1 2 | $ php application.php list --verbose
$ php application.php list -v
|
Чтобы вывести еще более детализированные сообщения, вы можете использовать эти опции:
1 2 | $ php application.php list -vv
$ php application.php list -vvv
|
Если вы установите необязательные аргументы, чтобы дать вашему приложению имя и версию:
$application = new Application('Acme Console Application', '1.2');
То вы можете использовать:
1 2 | $ php application.php list --version
$ php application.php list -V
|
Чтобы получить такой вывод информации:
1 | Приложение Acme Console версия 1.2
|
Если вы не предоставите имени консоли, тогда будет выведено просто:
1 | инструмент консоли
|
Вы можете формировать влкючение выделения цветом вывода ANSI с помощью:
1 | $ php application.php list --ansi
|
Или выключить его с помощью:
1 | $ php application.php list --no-ansi
|
Вы можете подавить любые интерактивные вопросы команды, которую вы запускаете, с помощью:
1 2 | $ php application.php list --no-interaction
$ php application.php list -n
|
Синтаксис ярлыков¶
Вам не нужно печатать полные названия команд. Вы можете просто напечатать
кратчайшее однозначное имя, чтобы запустить команды. Поэтому, если сталкивающихся
команд нет,то вы можете запустить help
таким образом:
1 | $ php application.php h
|
Если у вас есть команды, использующие :
в пространстве имён, то вам просто нужно
напечатать кратчайший однозначный текст для каждой части. Если вы создали
demo:greet
так, как показано в The Console Component, то вы можете
запустить его с помощью:
1 2 3 4 5 6 | $ php application.php d:g Fabien
# вы также можете смешивать верхний и нижний регистр при соблюдении однозначности
# php application.php Demo:g Fabien
# php application.php de:Gr Fabien
# php application.php DE:Gre Fabien
|
Если вы введёте короткую неоднозначную команду (т.е. существует более одной совпадающей команды), то не будет запущена ни одна команда и будут выведены несколько вариантов возможных команд на выбор.
Эта документация является переводом официальной документации Symfony и предоставляется по свободной лицензии CC BY-SA 3.0.