Консоль — обзор

Всё, что делается вокруг проекта, делается через один файл — call. Он запускает сервер, генерирует классы, накатывает схему, управляет фоновыми компонентами и выполняет ваши собственные скрипты. Один разбор аргументов, один формат вывода, один контейнер.

Зачем нужна консоль

Разработке нужен не только цикл «запрос — ответ»: создать компонент, поднять сервер, накатить схему, прогреть кеш, запустить фоновый обработчик, разово выполнить скрипт. Без общего инструмента это набор разрозненных файлов в корне проекта, у каждого свой способ принять аргументы и своё представление о том, как печатать ошибку.

call даёт единый вход: одинаковый разбор аргументов, одинаковый вывод, доступ к контейнеру и к конфигурации приложения — и для встроенных команд, и для ваших.

Как устроен вызов

php call <команда> [подкоманда] [аргументы] [-флаги] [--опции[=значение]]

Разбор раскладывает $argv на три части:

Первый аргумент — имя команды; без него выполняется help. Флаги можно писать и раздельно, и слитно: -c -s -r и -csr эквивалентны.

Короткие имена

Четыре команды имеют алиасы:

Запуск откуда угодно

Файл call содержит chdir(__DIR__), поэтому команды работают из любого каталога — достаточно указать путь:

php /srv/my-app/call mapping show

Это же делает вызовы из systemd, cron и docker exec предсказуемыми: рабочий каталог значения не имеет.

Команды

Разработка

Окружение и данные

Фоновые компоненты

Служебные

Справка

php call                 # то же, что help
php call help            # список команд + версии PHP, ядра и проекта
php call help make       # подробная справка по команде
php call make -h         # то же самое флагом

call help без аргументов печатает ещё и окружение — версию ядра, версию PHP, SAPI и корень проекта. Это первое, что стоит приложить к вопросу «почему у меня не работает».

Автодополнение

php call cfg completion       # напечатать скрипт в stdout
php call cfg completion -i    # установить
php call cfg completion -if   # переустановить поверх

Оболочка определяется по $SHELL. Для zsh файл кладётся в ~/.zsh/completions/_call и в ~/.zshrc дописывается fpath; для bash — в ~/.bash_completion.d/call. После установки дополняются имена команд, подкоманды и — там, где это осмысленно — имена классов проекта.

Своя команда

Класс, наследующий Cmd. Скаффолд — php call make -n .Sync:

use Flytachi\Winter\Console\Inc\Cmd;

class Sync extends Cmd
{
  public static string $title = 'sync external data';

  public function handle(): void
  {
      $from = $this->args['options']['from'] ?? 'yesterday';

      self::printInfo("syncing since {$from}");
      // ...
      self::printSuccess('done');
  }

  public static function help(): void
  {
      self::printInfo('call script main.command.Sync --from=2026-01-01');
  }
}

php call sc main.command.Sync --from=2026-01-01

Аргументы приходят в $this->args — теми же тремя частями: arguments, flags, options.

Зависимости

Команда создаётся контейнером, поэтому внедрение работает как везде:

class Sync extends Cmd
{
  #[Autowired] private ExchangeService $exchange;
  #[Autowired] private LoggerInterface $logger;

  public function handle(): void
  {
      $this->logger->info('sync started');
      $this->exchange->pull();
  }
}

Cmd или CmdCustom

Обе находятся сканером и обе запускаются через call script. Разница только в объёме обязательного оформления — см. script.

Вывод

Печатать через echo не нужно — у Printer есть готовые формы, и весь вывод консоли выглядит одинаково:

Исключение, вылетевшее из handle(), перехватывается и печатается через printError() — команда не падает стектрейсом PHP в консоль.

Дальше

• make — генерация компонентов
• run — запуск приложения
• script — свои команды
• Состав приложения — что именно запускает run