Что вошло в 1.2 — и почему маркетплейс проверяет пакеты офлайн
Разбираем релиз, в котором появился маркетплейс, и логику проверки подписи, которой не нужна сеть.
В версии 1.2 в админке появился маркетплейс: модули и темы ставятся одной кнопкой, а не через FTP. Интересное здесь не кнопка.
Zip из интернета — это код, который вы исполняете
Установить пакет значит положить PHP-файлы на сервер, где они выполняются с теми же правами, что и продукт. Это серьёзное действие для ссылки на скачивание, а большинство экосистем плагинов просто просят доверять каталогу.
Мы не хотели, чтобы это доверие было единственным барьером, поэтому пакет маркетплейса — подписанный артефакт:
marketplace-manifest.json slug, версия, каждый файл с SHA-256
marketplace-manifest.sig подпись Ed25519 над манифестом
files/<path> содержимое
Публичный ключ лежит внутри продукта. Проверка идёт локально, до распаковки, и не требует сети: каталог может быть недоступен, пакет всё равно проверяем.
Что проверяется, по порядку
- Подпись публичным ключом из установки.
- Контрольная сумма каждого файла против манифеста.
- Slug, тип и версия внутри
module.jsonилиtheme.jsonпротив подписанного манифеста. - Диапазон совместимости против версии CMS.
- Что каждый путь остаётся внутри целевого каталога — path traversal именно запрещается, а не «санитизируется».
Пакет с одним изменённым байтом падает на шаге 2. Пакет, выдающий себя за другой продукт, — на шаге 3.
Установить — не значит включить
Два решения, которые выглядят мелкими и важны на практике:
- После установки модуль выключен. Включаете, когда готовы.
- Тема не активна, пока вы не нажмёте Activate. В момент, когда файлы легли на диск, витрина не меняется.
Установку, которая молча меняет рабочий сайт, невозможно отлаживать в пятницу вечером. Установка, которая кладёт файлы и ждёт, скучна — в этом и смысл.
Откат — часть установки
Предыдущая сборка уезжает в storage/app/marketplace/rollback до того, как встанет новая, а замена атомарна. Если копирование упало на середине, старая сборка возвращается, и сайт продолжает рендериться.
Принцип тот же, что у апдейтера: неудачное изменение должно оставить систему в том состоянии, в котором она была до нажатия кнопки.
Лицензия, которая не ломает работающие сайты
Для установки нового нужна действующая лицензия. Уже установленное работает бессрочно, в том числе после окончания года поддержки.
Асимметрия намеренная. Истёкшая лицензия должна приостанавливать магазин, а не выключать билетную кассу площадки в субботу. Продукт блокирует покупку нового и никогда не трогает способность сайта продавать.