Міграція з Drupal 7 на Drupal 10: інструкція та практичні приклади

Drupal 7 більше не отримує оновлень безпеки. Сайт під загрозою атак, а прямого шляху до Drupal 10 немає — тільки повноцінна міграція. Ми провели 20+ таких проєктів: від 50 до 200 000 нод. Наш досвід дозволяє обійти типові пастки та вкластися в мінімальний downtime.

Migrate API прискорює перенесення контенту в 3–5 разів порівняно з ручним вивантаженням. Але міграція — це не лише контент: кастомні модулі та теми доводиться переписувати повністю. Drupal 7 — процедурний і без Composer, Drupal 10 — OOP на Symfony з YAML-роутингом. Різниця архітектур неминуче призводить до повного рефакторингу коду.

Міграція з Drupal 7 на Drupal 10: покрокова інструкція

Архітектурні відмінності: чому це не апгрейд

Drupal 7 та Drupal 10 — архітектурно різні системи. D7 не використовує Composer, OOP, Symfony компоненти. Контент мігрується через Migrate API, код тем і модулів переписується повністю. Це повноцінний рефакторинг, а не оновлення. Наприклад, hook_menu в D7 перетворюється на YAML-маршрути, а процедурні функції — на сервіси Dependency Injection.

Стратегії міграції: як обрати?

Migrate API — рекомендований варіант. Він дозволяє запускати міграції багаторазово, додаючи лише змінений контент. Різниця в трудозатратах між Migrate API та ручною міграцією становить 3–5 разів на користь автоматизації. Економія бюджету при використанні Migrate API досягає 60-80%.

Як перенести кастомні модулі?

Кастомні модулі Drupal 7 потрібно повністю переписувати під архітектуру Drupal 10. Наприклад, hook_menu замінюється на YAML-файл mymodule.routing.yml, а процедурні функції — на класи з анотаціями. Складність переписування залежить від розміру модуля. Часто потрібен рефакторинг всієї бізнес-логіки. Замовте аудит вашого сайту, щоб оцінити трудомісткість.

Як ми проводимо міграцію: покроково

Спочатку проводимо повний аудит поточного сайту. Заходимо на сервер D7 і збираємо метрики: список активних модулів, типи нод, розмір БД. Потім на новому сервері розгортаємо Drupal 10 та встановлюємо пакети міграції.

composer create-project drupal/recommended-project drupal10-site cd drupal10-site composer require drupal/migrate_plus drupal/migrate_tools drupal/migrate_upgrade drupal/migrate_source_csv drush en migrate migrate_plus migrate_tools migrate_upgrade -y 

Підключаємо базу D7 як додаткову в settings.php:

$databases['migrate']['default'] = [ 'driver' => 'mysql', 'database' => 'drupal7_db', 'username' => 'db_user', 'password' => 'db_pass', 'host' => '127.0.0.1', 'port' => '3306', 'prefix' => '', ]; 

Команда drush migrate:upgrade генерує YAML-конфігурації для користувачів, таксономії, типів контенту, полів, нод, файлів, блоків та меню. Потім міграції запускаються в порядку залежностей: спочатку ролі, потім типи контенту, поля, таксономія, користувачі, файли, ноди, меню та блоки.

drush migrate:import upgrade_d7_user_role drush migrate:import upgrade_d7_node_type drush migrate:import upgrade_d7_field drush migrate:import upgrade_d7_field_instance drush migrate:import upgrade_d7_taxonomy_vocabulary drush migrate:import upgrade_d7_taxonomy_term drush migrate:import upgrade_d7_user drush migrate:import upgrade_d7_file drush migrate:import upgrade_d7_node_complete drush migrate:import upgrade_d7_menu drush migrate:import upgrade_d7_block 

Проблемні зони та їх рішення

• CCK/Field API: Field Collection в D7 не мігрується напряму — потрібен модуль migrate_field_collection.
• Views: Views 3 (D7) переносяться частково. Складні представлення з relationships доведеться перестворювати вручну.
• Медіафайли: Файли копіюються через file_copy плагін, джерело вказується як source_base_path.

Отримайте консультацію — ми оцінимо складність вашого проєкту та запропонуємо оптимальний план.

Як мінімізувати downtime?

Використовуємо дельта-міграцію. За кілька днів до перемикання запускаємо первинну міграцію всього контенту. У день перемикання спочатку вмикаємо режим обслуговування на D7, потім запускаємо інкрементальне оновлення: drush migrate:import --all --update. Після цього перемикаємо DNS на D10 та вимикаємо режим обслуговування. Весь downtime — 15-30 хвилин. Зв'яжіться з нами для оцінки вашого проєкту.

Що входить в роботу?

• Повний аудит поточного D7-сайту (модулі, теми, контент, DB)
• Міграція контенту через Migrate API з гарантією цілісності
• Перепис кастомних модулів та тем на OOP/Symfony
• Налаштування SEO-модулів (metatag, redirect, pathauto)
• Тестова міграція та приймальне тестування
• Документація з нової архітектури, доступи до сервера та адмінки
• Пост-міграційна підтримка на 2 тижні

Замовте аудит D7-сайту, щоб отримати точні терміни та вартість.

Терміни та вартість

Вартість розраховується індивідуально після аудиту. Зв'яжіться з нами, щоб обговорити деталі.