MigrateMODX 1.3.31: префлайт переезда MODX 2 → 3, снимки, Recovery и heal MiniShop3

Привет! Выпускаю MigrateMODX 1.3.31 — CMP для управляемого переезда MODX 2.6.5–2.8.x на MODX 3 и подготовки PHP 7.4 → 8+. Это префлайт и инвентарь: матрица пакетов, сканы PHP и шаблонов, снимок, Recovery Console, оркестратор дистрибутивов и heal витрины после ms2 → MiniShop3. Не «сайт за пару кликов» и не замена соседнему стеку MODX 3 + агент + плейбуки.

!!! ВАЖНО!!!

Запускайте MigrateMODX только на копии проекта (staging), не на проде. Полный «гарантированный» переезд любого сайта компонент не обещает — кастом и неизвестные пакеты всё равно разбираются руками или агентом.

!!! ВАЖНО!!!

Два режима
В CMP есть Simple и Expert.

Simple ведёт по фазам: выбрать цель (остаться на 2.x и вычистить PHP 8.x, либо идти на 3), закрыть блокеры, сделать снимок, накатить ядро, проверить health.

Expert: вкладки аудита, пакетов, PHP, шаблонов и плана

Expert открывает те же данные по вкладкам: обзор, пакеты, PHP, шаблоны/чанки, план, снимок. Удобно, когда нужно разобрать конкретный блокер или скормить отчёт агенту.
Что делает компонент

Аудит — окружение, установленные пакеты по базе знаний (compatible / replaced_by / unknown), кастомный PHP под MODX 3 и PHP 8, синтаксис MODX/pHx и Fenom.
PHP 8+ prep — скан и безопасный autofix (
```
$arr{0}
```
→
```
$arr[0]
```
,
```
${var}
```
→
```
$var
```
) с журналом и откатом.
Attention Report — инвентарь known/unknown для рук или агента, не вердикт «сайт разобран».
Снимок + Recovery — файлы ядра и дамп БД; аварийный вход работает при белом экране manager.
Оркестратор — скачивание и применение 2.8.8 / 3.0.0 (целевой 3.0.3+ под MiniShop3), затем
```
/setup/
```
и health check.
ms2 → MiniShop3 — dry-run и перенос данных плюс heal витрины: minicart, страница корзины
```
#msCart
```
, live-sync количества, аккуратный dedupe формы заказа.

Снимок и Recovery
Перед накатом ядра на вкладке «Снимок и recovery» создаёте снимок и включаете Recovery Console. Пароль показывается один раз — сохраните. В CMP остаются полный URL с token, короткий ярлык

/migratemodx-recovery.php

и список снимков с проверкой и откатом.

Вкладка «Снимок и recovery»: Recovery активен, URL и список снимков

Recovery — отдельная веб-страница в

assets

, без manager. Если после

/setup/

manager белый или не пускает — заходите по сохранённому URL и паролю. После успешного переезда выключите Recovery на этой вкладке, чтобы закрыть аварийный вход.
Recovery UI
Экран входа: пароль и token из CMP. Token должен совпасть с тем, что выдали при создании снимка.

После Unlock открывается консоль:

Broken manager after /setup/? — quarantine для Tickets / AdminTools / Batcher (переименовывает папки в
```
.__disabled_for_modx3
```
и чистит
```
core/cache
```
). Либо тот же шаг через FTP.
Incident status — фаза миграции, last error, хвост журнала из store.
Diagnostics — PHP, наличие core, config.inc.php, соединение с БД, хвост
```
error.log
```
.
Snapshots — список снимков и Rollback файлов/БД с подтверждением; после отката прогресс MigrateMODX сбрасывается.
Download incident report — JSON со state, диагностикой и снимками.

Recovery Console: quarantine, incident status, diagnostics и snapshots

Если manager пустой после setup, есть ещё

/migratemodx-firstaid.php

— короткий first-aid без FTP. Основной путь всё равно Recovery Console по token + паролю.
Обзор готовности

Обзор: блокеры, предупреждения и сводка перед переездом

Сводка собирает блокеры и предупреждения в одном месте. Сначала закрываете блокеры, потом снимок и Apply. Карта пакетов показывает замены вроде miniShop2 → MiniShop3, SeoFilter / mSearch2 → msCatalyst.
Рекомендуемый порядок