Терминал, Composer и Node

Встроенный терминал сайта, портативные Composer и Node 24, зеркала и пресеты CLI.

Терминал сайта: PHP, Composer и Node 24 из поставки Omut, команда omut-cli

На странице сайта есть кнопка Терминал — встроенная консоль с готовым окружением проекта. Она открывается панелью внизу страницы, рядом с вкладками сайта.

Рабочий каталог и PATH

cwd — корень сайта (~/Omut/имя.bitrix/), не www/.
В PATH подставляются php (версия сайта), composer и node/npm из каталога данных Omut, а также команды пакетов, установленных через npm i -g.
Переменные: OMUT_SITE, OMUT_SITE_ROOT, OMUT_DOCUMENT_ROOT, OMUT_PHP, COMPOSER_HOME, npm registry.

Composer и Node не скачиваются при «Запустить окружение». Они подтягиваются с CDN при первом открытии терминала (идемпотентно). Homebrew не используется.

Пресеты

В шапке терминала:

composer install
php www/bitrix/bitrix.php (для старых сайтов без www/ — php bitrix/bitrix.php ; команда без Enter, можно дописать аргументы)
npm i -g @bitrix/chef

Пакет @bitrix/chef — актуальный CLI Битрикса, @bitrix/cli устарел.

Пресет ставит chef один раз для всех сайтов, в папку данных Omut. Обновление Node его не удаляет. Если chef установлен в самом проекте (npm i -D @bitrix/chef), терминал запустит эту копию.

Запускайте его просто chef, например chef create vendor.feature. Chef ищет Битрикс в текущей папке и выше, а терминал открывается в корне сайта, где Битрикса нет: он лежит в www/. Поэтому из корня сайта Omut запускает chef в папке www/, а из любой другой папки — там, где вы находитесь. Через npx chef из корня сайта chef Битрикс не найдёт.

Composer и структура сайта

После успешной установки Битрикса «под ключ» Omut (merge-safe) может создать:

composer.json в корне сайта с wikimedia/composer-merge-plugin → www/bitrix/composer-bx.json (или bitrix/… на legacy);
autoload в www/local/php_interface/init.php;
секцию composer в .settings.php.

Существующие файлы и секции не перетираются. При открытии терминала на уже установленном сайте scaffold при необходимости дополняется идемпотентно.

Зеркала

По умолчанию Composer и npm качают пакеты через зеркала для России. Сменить их можно в Настройках → Окружение → Общие параметры окружения: для Composer — Зеркало Aliyun или Packagist напрямую, для npm — npmjs.org напрямую.

Платформы

Терминал доступен на macOS, Linux и Windows (на Windows — встроенный ConPTY и оболочка cmd.exe). Рабочий каталог тот же — корень сайта.