upgrade

Обзор

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

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

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

Синтаксис

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

Справочник

Руководство по upgrade

В Minimum можно обновить все модули или один по имени. Проверка -c, выбор нескольких команд и автоматические действия требуют Base.

Прежде чем обновлять модули на рабочем сайте, посмотри, что именно изменится. upgrade -c проверяет версии и зависимости, не заменяя PHP-код. upgrade hash -c делает такую проверку только для выбранной команды.

upgrade hash обновляет или восстанавливает установленный модуль, сохраняя его вариант Base/Minimum и источник. Просто upgrade обрабатывает все установленные модули. Если команды ещё нет, сначала нужен install: обновление не подменяет установку.

upgrade -auto check настраивает проверку при запуске авторизованной сессии через run и autoload.lil. Режим -auto update может сам менять исполняемый PHP-код, поэтому по умолчанию выключен. Состояние показывает upgrade -info, отключение — upgrade -auto off. Встроенный cd обновляется заменой lil.php, а не через upgrade cd.

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

Маркер каждого установленного модуля хранит репозиторий, версию, пакет 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 ⌘, — а в конце идут компактные счётчики вроде Актуально: 10. Такой порядок позволяет быстро сравнивать несколько обновлений.

Встроенные команды cd и core входят в Core. upgrade показывает их состояние, но обновляются они заменой lil.php, а не отдельно.

Пакет Base обозначается ⌘, Minimum по-прежнему обозначается (minimum).

Результат одного модуля

При проверке или обновлении одного модуля выводятся только версии и обозначение пакета: например, v1.1.5 ⌘ или v1.1.4 > v1.1.5 ⌘. Название команды и подписи Current/Available не дублируются. При недоступности исходника повторно запрашивается та же версия.

Теперь upgrade принимает несколько названий модулей в одной команде, включая проверку с -c. Обновляются только выбранные модули и необходимые зависимости.

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

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

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

Примеры

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

Подготовленный учебный ответ. Кнопка Play не изменяет твою установку.
Status  All 3 modules are current
Фактический результат зависит от установленных пакетов и состояния репозитория.

Подготовленный учебный ответ. Кнопка Play не изменяет твою установку.
All installed extension modules are current
Фактический результат зависит от установленных пакетов и состояния репозитория.

Подготовленный учебный ответ. Кнопка Play не изменяет твою установку.
v1.1.4
Фактический результат зависит от установленных пакетов и состояния репозитория.

Подготовленный учебный ответ. Кнопка Play не изменяет твою установку.
v1.1.4
Фактический результат зависит от установленных пакетов и состояния репозитория.

Подготовленный учебный ответ. Кнопка Play не изменяет твою установку.
v1.1.5
Фактический результат зависит от установленных пакетов и состояния репозитория.

Подготовленный учебный ответ. Кнопка Play не изменяет твою установку.
Selected (check)  3
attr     v1.3.2
stat     v1.1.6
include  v1.2.6
Фактический результат зависит от установленных пакетов и состояния репозитория.

Подготовленный учебный ответ. Кнопка Play не изменяет твою установку.
All 3 selected modules are current
Фактический результат зависит от установленных пакетов и состояния репозитория.

Подготовленный учебный ответ. Кнопка Play не изменяет твою установку.
Built-in  cd · Core v1.5.x
Update    replace lil.php to update
Фактический результат зависит от установленных пакетов и состояния репозитория.

Подготовленный учебный ответ. Кнопка Play не изменяет твою установку.
Built-in  core · Core v1.5.x
Update    replace lil.php to update
Фактический результат зависит от установленных пакетов и состояния репозитория.

Подготовленный учебный ответ. Кнопка Play не изменяет твою установку.
Automatic upgrade  Check only
Session command     upgrade -c
Script              autoload.lil
Фактический результат зависит от установленных пакетов и состояния репозитория.

Подготовленный учебный ответ. Кнопка Play не изменяет твою установку.
Automatic upgrade  Check only
Run module         Installed
Script             autoload.lil
Фактический результат зависит от установленных пакетов и состояния репозитория.

Подготовленный учебный ответ. Кнопка Play не изменяет твою установку.
Automatic upgrade  Update automatically
Session command     upgrade
Script              autoload.lil
Фактический результат зависит от установленных пакетов и состояния репозитория.

Подготовленный учебный ответ. Кнопка Play не изменяет твою установку.
Automatic upgrade  Off
Script             autoload.lil
Фактический результат зависит от установленных пакетов и состояния репозитория.

Подготовленный учебный ответ. Кнопка Play не изменяет твою установку.
missing_module: not installed

Подготовленный учебный ответ. Кнопка Play не изменяет твою установку.
?

Подготовленный учебный ответ. Кнопка Play не изменяет твою установку.
?

Подготовленный учебный ответ. Кнопка Play не изменяет твою установку.
?

Подготовленный учебный ответ. Кнопка Play не изменяет твою установку.
v1.4.8
Фактический результат зависит от установленных пакетов и состояния репозитория.

Подготовленный учебный ответ. Кнопка Play не изменяет твою установку.
v1.3.6
Фактический результат зависит от установленных пакетов и состояния репозитория.

Подготовленный учебный ответ. Кнопка Play не изменяет твою установку.
Selected (check)  2
hash  v1.1.4
pwd   v1.1.5
Фактический результат зависит от установленных пакетов и состояния репозитория.

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

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

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