Використання консольних команд, ярликів та вбудованих команд

Дата оновлення перекладу 2022-10-27

Використання консольних команд, ярликів та вбудованих команд

На додаток до опцій, які ви вказуєте для ваших команд, існують ще вбудовані опції, а також деілька вбудованих команд для компонента Консоль.

Note

Ці приклади припускають, що ви додаил файл application.php для запуску в cli:

        1
2
3
4
5
6
7
8
9
10
11
        #!/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
    

Якщо ви встановите необовʼязкові аргументи, щоб дати вашому додатку імʼя та версію:

        1
        $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 так, як продемонстровано в Компонент Консоль, то ви можете запустити його за допомогою:

        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
    

Якщо ви введете коротку неоднозначну команду (тобто, існує більше однієї команди, що співпадає), то не буде запущено жодну команду, і будуть виведені декілька варіантів можливих команд на вибір.

Використання консольних команд, ярликів та вбудованих команд

Використання консольних команд, ярликів та вбудованих команд

Вбудовані команди

Глобальні опції

Синтаксис ярликів