run

Обзор

Повторяющиеся операции удобно записать в .lil-файл и запускать через run. Начинай с -n, чтобы проверить шаги без выполнения.

Автоматизация остаётся внутри lil-terminal

Каждая строка выполняется как обычная команда lil-terminal. Зависимости устанавливаются заранее, @command внутри сценария не используется, -n показывает развёрнутые команды без выполнения, а -x требуется для привилегированных неинтерактивных команд вроде php и ses.

Синтаксис

run <file.lil|[script]> [-n|-v|-k|-x] · run -p <source.lil> [target.lil]

Справочник

На практике

Повторяешь одни и те же действия с файлами? Сохрани команды в текстовый .lil-файл и запускай их через run. Команда выполняет шаги последовательно, показывает ошибки и использует команды самого lil-terminal — не системную оболочку сервера.

Начни с run sandbox/scripts/workflow.lil -n: это предварительная проверка без выполнения. Затем убери -n. Для маленькой задачи подойдёт запись run [pwd | pwd], где | разделяет команды внутри сценария.

В файле каждая команда занимает свою строку. set сохраняет переменную, capture запоминает текст результата, if и else выбирают действия, run вызывает вложенный сценарий. В примере workflow.lil команда if file ${source} проверяет наличие файла, прежде чем продолжать.

-v показывает вывод всех операций. По умолчанию выполнение прекращается при первой ошибке; -k продолжает следующие шаги, но общий результат остаётся Stopped, если была ошибка. Пробный запуск -n не гарантирует, что реальный запуск позже завершится успешно.

Простой файл с первой строкой #lil запускается встроенным механизмом Base Core: только команды по порядку. Полный run нужен для переменных, условий и вложенных процессов. Minimum рассчитан на один аргумент — имя файла. Короткая запись без пробелов, например run [pwd], тоже может работать; для нескольких inline-команд и дополнительных флагов нужен Base.

setup.lil рядом с lil.php выполняется после авторизации и удаляется только при успехе; autoload.lil выполняется раз за авторизованную сессию. -p упаковывает сценарий в формат @LIL1 с SHA-256 и DEFLATE, но **не шифрует** его.

Сценарии работают с правами текущего PHP-пользователя. Интерактивные действия и @install запрещены; для неинтерактивных php/ses нужен явный -x. Лимиты: текст 256 КиБ, упакованный файл 384 КиБ, 1000 команд, 10 уровней вложенности, 60 секунд. Автоматического отката файловых изменений нет.

Подробности

Обычный текст ограничен 256 КиБ, упакованный вход — 384 КиБ, сценарий — 1000 командами, вложенность — 10 уровнями, время — 60 секундами. Упаковка использует SHA-256 и DEFLATE для целостности, но не является шифрованием.

Безопасность

Сценарии выполняются с правами текущего PHP-процесса. Интерактивные команды запрещены, а php и ses доступны только с явным -x. Не запускайте непроверенные сценарии.

Автоматическая установка

Сокращение @command относится к интерактивному ядру, а не к языку автоматизации. .lil-сценарий, пытающийся начать команду с @, отклоняется. Зависимости сценария следует устанавливать явно до запуска автоматизации, чтобы рабочий процесс не менял набор исполняемых модулей неявно.

Линейные сценарии ядра и run

Файл, начинающийся с #lil, намеренно проще сценария Run: каждая строка, не являющаяся комментарием, — обычная команда терминала; верхнеуровневые разделители | выполняются слева направо, а первая ошибка останавливает последовательность. Такой файл запускается непосредственно по пути или через < file.lil. Используйте run, когда нужны переменные, условия, вложенные сценарии, захват результата, проверочный запуск или другие средства управления потоком.

Во всём сценарии, включая вложенные .lil, допускается не более 1000 непустых строк-команд и инструкций. При ошибке проверки -n выводит Stopped, а не Checked; предварительная проверка ничего не исполняет.

Установка и управление

Устанавливайте актуальную совместимую версию. Для полного набора возможностей выбирайте Base, для сокращённого — Minimum; уже установленный модуль обновляет команда upgrade.

Base и Minimum — два пакета одного текущего релиза модуля, а не разные версии команды.

Примеры

Примеры можно копировать, но сайт их не выполняет. Перед запуском на реальном проекте проверьте пути, права и разрушающие флаги.

001 + pwd
002 + pwd
Completed: 2

001 + pwd
    sandbox
002 + pwd
    sandbox
Completed: 2

001 · pwd
002 · pwd
Checked: 2

001 · pwd
002 · pwd
Checked: 2

001 + pwd
002 + pwd
Completed: 2

001 + pwd
002 + pwd
Completed: 2

001 + pwd
Completed: 1

001 + pwd
Completed: 1

001 + pwd
Completed: 1

001 + pwd
    sandbox
002 + pwd
    sandbox
Completed: 2

001 + pwd
    sandbox
002 + pwd
    sandbox
Completed: 2

001 – upload
    Command is not allowed in scripts
Stopped: 1

001 – upload
    Command is not allowed in scripts
002 + pwd
Stopped: 2

Line 001 – maintenance
Stopped: 0

001 + pwd
002 – php -v
    Command is not allowed in scripts
Stopped: 2

001 + pwd
    sandbox
002 + php -v
    PHP 8.4.24
Completed: 2

001 – php -v
    Command is not allowed in scripts
Stopped: 1

001 + php -v
    PHP 8.4.24
Completed: 1

001 · pwd
Line 003 – Missing end
Stopped: 1

Recursive script detected
Stopped: 0

001 – @install find
    Automatic installation is not allowed in scripts
Stopped: 1

001 – upload
    Command is not allowed in scripts
002 + pwd
Stopped: 2

Packed workflow.lil > sandbox/scripts/workflow.export.lil
182 B > 256 B

001 + pwd
002 + pwd
Completed: 2

001 · pwd
002 · pwd
Checked: 2

001 – @install find
    Automatic installation is not allowed in scripts
Stopped: 1

001 – upload
    Command is not allowed in scripts
Stopped: 1

Script file not found

Script must use the .lil extension

Unknown run option: -z

Inline script is missing ]

?

# lil-sandbox workflow
pwd
dir 1 sandbox
echo sandbox/data/sample.txt

Связанные команды

Фиолетовая ссылка на команду означает, что для этой возможности нужен другой модуль. Откройте связанную команду, чтобы узнать, что она даёт и как её установить.

Связанная документация