upgrade

Обзор

upgrade превращает обслуживание модулей в предсказуемый процесс: сначала можно проверить план, затем обновить один модуль или всю установку, восстановить совместимые зависимости, а при установленном run — при желании запускать одну проверку или попытку обновления в начале каждой авторизованной сессии.

Сначала проверить план, затем менять код

upgrade -c проверяет версии, пакеты и зависимости без записи исходников модулей. Реальное обновление сохраняет выбранный пакет и репозиторий, атомарно заменяет модули и обращается к install только если обязательной зависимости ещё нет вообще.

Синтаксис

upgrade [module] [-c] · upgrade -auto <check|update|off> · upgrade -info

Справочник

Планирование

Маркер каждого установленного модуля хранит репозиторий, версию, пакет Base или Minimum и поколение lil.core. upgrade находит новейший совместимый публичный релиз в том же репозитории, сохраняет выбранный пакет, проверяет метаданные совместимости и никогда не понижает версию, которая уже выше серверной.

Обновление и восстановление

Существующие модули загружаются, нормализуются, разбираются, проверяются на конфликт методов и заменяются атомарно. Для зависимостей проверяются репозиторий, пакет, версия и поколение ядра. Уже установленную зависимость upgrade обновляет или расширяет сам; только полностью отсутствующая зависимость передаётся install.

Режим проверки

-c выполняет тот же анализ версий, пакетов и зависимостей, но не загружает исходник модуля и не изменяет файл расширений. Для важного проекта это лучший первый шаг перед ручным или автоматическим обновлением.

Автоматический режим

Автоматический режим использует существующий механизм запуска run и файл autoload.lil. upgrade изменяет только собственный маркированный блок # <upgrade:auto> и сохраняет все остальные строки сценария. check добавляет автоматический upgrade -c, update — автоматический upgrade, а off удаляет только этот служебный блок. Режимы check и update взаимоисключающие.

Поскольку autoload.lil выполняется один раз за авторизованную сессию, проверка или обновление запускаются после входа в терминал, а не перед каждой командой. Для автоматического режима нужен модуль run. Команда upgrade -info показывает текущий режим и ничего не записывает.

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

Автоматическое обновление по умолчанию выключено. Режим update загружает и заменяет исполняемый PHP-код модулей, поэтому используйте только доверенный репозиторий. Если изменения должны оставаться полностью явными, выбирайте check. Управляемый блок можно удалить в любой момент командой upgrade -auto off.

Формат сводки

Проверка или обновление всей установки начинается с краткого итога, затем изменённые модули выводятся строками с версиями впереди — например v1.30 > v1.33 help (base), — а в конце идут компактные счётчики вроде Актуально: 10. Такой порядок позволяет быстро сравнивать несколько обновлений.

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

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

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

Примеры

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

Доступно: 4 из 14
                v1.40	>	v1.42	help (base)
                v1.17	>	v1.18	include (base)
                v1.10	>	v1.11	ping (base)
                v1.8	>	v1.9	run (base)
Актуально: 9
Новее репозитория: 1

Обновлено 4 из 14
                v1.40	>	v1.42	help (base)
                v1.17	>	v1.18	include (base)
                v1.10	>	v1.11	ping (base)
                v1.8	>	v1.9	run (base)
Актуально: 9
Новее репозитория: 1

Доступно: 4 из 14
                v1.40	>	v1.42	help (base)
                v1.17	>	v1.18	include (base)
                v1.10	>	v1.11	ping (base)
                v1.8	>	v1.9	run (base)
Актуально: 9
Новее репозитория: 1

Доступно: 1 из 1
                v1.30	>	v1.33	help (base)

Обновлено 1 из 1
                v1.30	>	v1.33	help (base)

Обновлено 4 из 14
                v1.40	>	v1.42	help (base)
                v1.17	>	v1.18	include (base)
                v1.10	>	v1.11	ping (base)
                v1.8	>	v1.9	run (base)
Актуально: 9
Новее репозитория: 1

Automatic upgrade  Check only
Session command    upgrade -c
Script             autoload.lil

Automatic upgrade  Check only
Run module         Installed
Script             autoload.lil

Automatic upgrade  Update automatically
Session command    upgrade
Script             autoload.lil

Automatic upgrade  Off
Script             autoload.lil

missing_module: не установлен

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

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

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