Обновление MAJOR-версии Друпала: инструменты и процесс

Когда выходит новая MAJOR-версия Друпала, пользовательский код часто требует обновления, чтобы соответствовать изменениям в API. Так как я постоянно забываю некоторые аспекты этого процесса, то я решил задокументировать его на будущее.

Обзор инструментов

Моудль Upgrade Status

Модуль Upgrade Status оценивает готовность сайта к переходу на новую MAJOR-версию, проверяя устаревший код и другие проблемы совместимости.

Установите его так же, как и любой другой модуль:

ddev это инструмент, который я предпочитаю для управления своей локальной средой разработки. composer это менеджер зависимостей для PHP, который обычно используется для установки модулей. Параметр –dev говорит о том, что модуль устанавливается в среду разработки.

После установки, включаем:

drush расшифровывается как Drupal shell и является утилитой командной строки для управления сайтами на Друпале. Команда pm:enable используется для включения модуля в Друпале (pm расшифровывается как package manager).

После включения модуля, можно посмотреть его отчёты о совместимости проектов на странице Admin → Reports → Upgrade status (/admin/reports/upgrade-status).

Обновление PHP и MySQL с использованием DDEV

Модуль Upgrade Status может рекомендвать обновление PHP и MySQL, на основе системных требований Друпала.

Для обновления версии PHP используйте команду:

Для обновления версии MySQL и миграции содержания базы данных, используйте команду:

После обновления этих параметров, я перезапускаю DDEV и запускаю свои тесты PHPUnit. Хотя все тесты интегрированы в мой процесс CI/CD, я запускаю их и локально, чтобы сразу увидеть результат.

Drupal Check

Drupal Check это инструмент командной строки, который сканирует проекты Друпала и определяет устаревший код и проблемы совместимости. Я всегда запускаю drupal-check перед обновлением кода своего сайта и сторонних зависимостей. Это позволяет убедиться в отстутствии проблем с совместимость текущего кода перед обновлением. Также я запускаю drupal-check сразу после обновления, чтобы обнаружить любый новые проблемы в обновлённом коде.

Вывод команды Drupal Check, указывающий на отсутствие устаревшего кода:

Установка.

Запуск Drupal Check из корня установленного Друпала. Обычно я увеличиваю ограничение по памяти, поэтому в команде указано --memory-limit 500M.

Использование PHPStan напрямую

В будущем, я хотел бы оценить, проще ли использовать PHPStan напрямую. Drupal Check это по сути оболочка вокруг PHPStan, предлагающая конфигурацию по умолчанию, например, автоматический запуск со второго уровня. Чтобы получить такой же результат в PHPStan, мне нужно было выполнить такую команду: