Jak zmigrować Drupala 7 do Drupala 11 z użyciem modułów? Poradnik
Zbliża się koniec wsparcia Drupala 7 (5 stycznia 2025 r.), co oznacza, że użytkownicy tego systemu stają przed koniecznością migracji do nowszej wersji. Z tego artykułu dowiesz się, jak sprawnie przeprowadzić migrację z Drupala 7 do Drupala 11, jakie kroki są kluczowe oraz na co warto zwrócić uwagę, by proces przebiegł bezproblemowo. Zachęcam do przeczytania artykułu lub obejrzenia wideo z serii Nowoczesny Drupal.
Dlaczego migracja z Drupala 7 jest konieczna?
Wsparcie dla Drupala 7 zakończy się na początku 2025 roku, co przełoży się na brak aktualizacji bezpieczeństwa i poprawek błędów. Dla firm i organizacji korzystających z tej wersji systemu, pozostanie przy niej może generować ryzyko podatności na ataki oraz problemy z kompatybilnością. Migracja do Drupala 11 nie musi być skomplikowana ani droga. Jest to konieczność oraz świetna okazja do unowocześnienia witryny i wykorzystania nowych funkcjonalności systemu.
Przygotowanie do migracji treści
Zanim przeprowadzimy migrację, należy podjąć kilka kroków, które przygotują naszą stronę do łatwego i bezproblemowego przeniesienia na Drupala 11.
1. Analiza aktualnej strony internetowej
Na początek warto zidentyfikować, jakie elementy strony będą wymagały migracji.
Na potrzeby tego poradnika, przygotowałem stronę na Drupalu 7 oraz z użyciem modułu Devel Generate wygenerowałem content, który będziemy migrować w dalszej części tekstu. I tak mamy:
- Typy zawartości (np. artykuł, prosta strona).
- Pola niestandardowe (np. paragraf typu hero banner z obrazkami, linkami i opisami).
- Użytkownicy i ich dane.
2. Przygotowanie środowiska
Kolejnym krokiem jest przygotowanie środowiska, do którego migrujemy nasze treści. Podejmujemy następujące kroki:
- Instalujemy czystą wersję Drupala 11 na lokalnym środowisku programistycznym. Przydatne będą nam narzędzia takie jak DDEV.
- Włączamy moduły wymagane do migracji: Migrate, Migrate Drupal, Migrate Drupal UI, które są w corze Drupala.
Przygotowujemy bazę danych z Drupala 7 i konfigurujemy połączenie w pliku
settings.php.
Przeprowadzenie migracji strony
Gdy środowisko oraz dane źródłowe są gotowe możemy przystąpić do uruchomienia migracji.
1. Konfiguracja modułu do migracji
Po uruchomieniu Drupala 11 i aktywacji modułów migracyjnych:
- przechodzimy do ustawień migracji,
- wybieramy źródło (Drupal 6 lub 7),
- ustawiamy “source connection” na migrate,
- definiujemy ścieżkę do Drupala 7 - /var/www/drupal7/docroot - czyli połączenie do źródłowej bazy danych.
2. Migracja zawartości
- Po wprowadzeniu danych źródłowych, system automatycznie zidentyfikuje moduły i typy treści do migracji.
- Na liście zobaczymy, które moduły zostaną poprawnie zmigrowane, a które mogą wymagać dodatkowej konfiguracji (np. moduły Paragraphs).
Po uruchomieniu procesu migracji, sprawdzamy efekty:
- czy wszystkie treści zostały poprawnie przeniesione,
- czy dane użytkowników, pliki i media są dostępne w nowym systemie.
Na co zwracać uwagę przy migracji strony do Drupala 11?
Przy migracji serwisu, poza treścią, należy także zwrócić uwagę na inne aspekty strony, które nie zostaną zmigrowane i mogą wymagać dodatkowej pracy.
1. Wygląd strony
Migracja przenosi treści, ale nie style. Nowy wygląd trzeba dostosować do Drupala 11, co może wymagać pracy programisty, szczególnie przy skomplikowanych projektach graficznych.
2. Moduły niestandardowe
Jeśli korzystamy z modułów customowych, ich kod może wymagać dostosowania do nowej wersji API Drupala. To zadanie może być czasochłonne w zależności od złożoności modułu.
3. Zastąpienie przestarzałych funkcji
W Drupalu 11 nie są już obsługiwane pewne funkcjonalności znane z Drupala 7, takie jak PHP w blokach lub zapytania SQL w szablonach. Te elementy trzeba dostosować lub zastąpić nowoczesnymi rozwiązaniami.
4. Kompatybilność modułów contribowych
Nie wszystkie moduły dostępne w Drupalu 7 zostały zaktualizowane do wersji Drupal 11. Przed migracją warto sprawdzić, czy kluczowe moduły są kompatybilne, aby uniknąć problemów po zakończeniu procesu.
Korzyści płynące z migracji do Drupala 11
Migracja do Drupala 11 nie tylko rozwiązuje problem końca wsparcia, ale także otwiera dostęp do nowoczesnych funkcji, takich jak:
- obsługa pola Media, pozwalająca na lepsze zarządzanie plikami,
- nowoczesny system szablonów oparty na Twig,
- zwiększona wydajność i bezpieczeństwo.
Migracja do Drupala 11 - podsumowanie
Migracja z Drupala 7 do Drupala 11 może być wyzwaniem, ale dzięki narzędziom migracyjnym dostarczanym przez Drupala proces ten jest prosty i intuicyjny. Kluczowe jest odpowiednie przygotowanie: analiza obecnej strony, przetestowanie migracji na środowisku lokalnym oraz dostosowanie modułów i wyglądu.
Jeśli Twoja strona nie zawiera skomplikowanych funkcji ani rozbudowanego frontendu, proces ten nie powinien być ani czasochłonny, ani kosztowny. W przypadku bardziej złożonych projektów warto skonsultować się z naszymi ekspertami, którzy pomogą oszacować zakres pracy i doradzą, jak najlepiej przeprowadzić migrację Drupala 7 do najnowszej wersji.
***
Ten artykuł powstał na bazie materiału wideo. Zapraszamy do subskrybowania kanału Nowoczesny Drupal, gdzie w każdy piątek o 12:00 publikujemy nowy film. Nasi eksperci prezentują rozwiązania lub gotowe narzędzia, które pomogą Ci wykorzystać pełen potencjał Drupala.
