Оновлення ядра Drupal за допомогою Composer

У цій статті припускається, що ви встановили Drupal за допомогою composer-проєкту, як-от drupal/core-recommended або drupal/dxpr-marketing-cms-project

Список доступних оновлень Drupal

composer outdated "drupal/*"

Якщо немає рядка, що починається з drupal/core, Composer не знає про жодне оновлення. Якщо оновлення є, продовжуйте командами нижче

Створення резервної копії інсталяції Drupal

Оновлюючи робочий сайт, завжди створюйте резервну копію перед оновленням, навіть якщо успішно випробували оновлення в середовищі розробки чи тестування. Використовуйте інструменти свого хостинг-провайдера, щоб створити резервну копію або знімок свого сайту на Drupal.

Оновлення коду ядра Drupal

якщо ви використовуєте drupal/core-recommended:

composer update "drupal/core-*" --with-all-dependencies

Щоб змоделювати оновлення й побачити, що відбулося б, нічого фактично не змінюючи, додайте --dry-run.

Оновлення до найновішої патч-версії ядра

Якщо хочете оновити свій сайт до найновішої патч-версії, але не до найновішої мінорної версії, додайте --with= для кожної залежності drupal/core-*, переліченої у файлі composer.json.

Наприклад, якщо 10.2 є поточною мінорною версією, а ви хочете оновити свій сайт до найновішої патч-версії 10.3:

composer update "drupal/core-*" --with-all-dependencies --with=drupal/core-recommended:~10.3.0 --with=drupal/core-composer-scaffold:~10.3.0

У цьому прикладі припускається, що drupal/core-recommended і drupal/core-composer-scaffold є єдиними залежностями ядра Drupal у файлі composer.json.

Оновлення до конкретної версії ядра

Загалом ми рекомендуємо не вказувати конкретну версію ядра Drupal під час оновлення, якщо ви точно не знаєте, що хочете закріпитися на конкретній версії. Якщо ж хочете закріпити свій сайт на конкретній версії, можете скористатися таким прикладом:

Щоб закріпити свій сайт на версії 10.3.6 й відповідно оновити всі залежності:

composer require drupal/core-recommended:10.3.6 drupal/core-composer-scaffold:10.3.6 drupal/core-project-message:10.3.6 --update-with-all-dependencies

Відкріплення від конкретної версії ядра

Якщо ваш сайт працює на закріпленій версії ядра Drupal і ви хочете оновити його до іншої версії, ви маєте два варіанти.

1. Можна виконати наведену вище команду composer require, щоб вказати нову закріплену версію ядра.
2. Можна відкріпити свою версію ядра й оновитися до найновішої версії Drupal.

Щоб відкріпити свою версію Drupal, виконайте цю команду:

composer require drupal/core-recommended drupal/core-composer-scaffold drupal/core-project-message --update-with-all-dependencies

Виконання оновлень бази даних

Для зручності ми додали Drush команди, потрібні для завершення оновлення, адже багатьом Drush здається швидшим і простішим за вебінтерфейс адміністрування.

Можна скористатися drush:

drush updatedb
drush cache:rebuild

Або можна відвідати сторінку [YOUR DOMAIN]/update.php у браузері.