Najczęstsze problemy podczas migracji strony Drupal dotyczą niepełnego przeniesienia plików, błędnych ścieżek w settings.php, brakujących zależności Composer oraz niezgodnych wersji PHP lub bazy danych. Warto też sprawdzić konfigurację cache, serwera, clean URLs, cron i DNS.
Spis treści
Niepełny transfer plików
Brak części plików może powodować niedziałające funkcje strony, brak obrazów i arkuszy stylów. Taki błąd może również wpływać na działanie cache oraz widoczność strony w wyszukiwarce. Drupal wskazuje niekompletny transfer plików jako jeden z typowych problemów podczas migracji witryny na nowego dostawcę hostingu. Dokumentacja Drupal
Objawy
- obrazy nie wyświetlają się mimo poprawnego działania pozostałej części strony,
- brakuje stylów lub elementów interfejsu,
- wybrane funkcje przestają działać po przeniesieniu.
Jak zapobiec problemowi
- Porównaj zawartość kopii plików z zawartością strony na starym hostingu.
- Sprawdź pliki Drupala, moduły, motywy oraz pliki użytkowników.
- Przed zmianą DNS otwórz stronę na nowym hostingu i sprawdź kilka podstron oraz formularzy.
Błędne ścieżki publicznych i prywatnych plików
Drupal korzysta ze ścieżek zapisanych w konfiguracji serwisu. Podczas migracji sprawdź wartości dotyczące publicznych i prywatnych plików w settings.php. Ścieżka, która działała na starym serwerze, może nie odpowiadać lokalizacji plików na nowym hostingu.
Objawy
- nowe pliki nie zapisują się w oczekiwanym miejscu,
- obrazy lub załączniki nie są dostępne,
- część strony działa, ale zawartość plików użytkowników nie jest widoczna.
Najpierw porównaj ścieżki w settings.php z rzeczywistą lokalizacją katalogów na nowym serwerze. Następnie sprawdź uprawnienia tych katalogów. Po zmianie wykonaj test zapisu i odczytu pliku z poziomu strony.
Brak zależności Composer
Jeżeli projekt Drupal jest zarządzany przez Composer, sama kopia kodu aplikacji może nie wystarczyć. Brak wymaganych zależności może uniemożliwić uruchomienie modułów lub całej strony. Po migracji porównaj pliki projektu oraz zależności z kopią używaną na starym hostingu. Aktualizowanie rdzenia Drupala przez Composer wymaga zachowania zależności projektu, dlatego zmianę hostingu i aktualizację rdzenia traktuj jako osobne działania. Dokumentacja Drupal dotycząca Composer
Objawy
- błąd pojawia się po włączeniu modułu lub motywu,
- strona nie uruchamia się po przeniesieniu plików,
- Drupal zgłasza brak klasy, modułu albo wymaganej biblioteki.
Nie usuwaj plików projektu w ramach przypadkowej naprawy. Przywróć komplet zależności używanych przez działającą wersję strony, a przed kolejnymi zmianami wykonaj kopię plików i bazy danych.
Niezgodna wersja PHP lub bazy danych
Zmiana dostawcy hostingu może oznaczać zmianę wersji PHP albo systemu bazy danych. Jeżeli środowisko nie jest zgodne z używaną wersją Drupala, modułami lub motywem, strona może zgłaszać błędy po migracji. Sprawdź wersje działające na starym hostingu i porównaj je z konfiguracją nowego środowiska.
Objawy
- błąd pojawia się podczas uruchamiania strony,
- strona działa częściowo po imporcie bazy danych,
- aktualizacja bazy danych kończy się błędem.
Najpierw przywróć zgodne środowisko, a dopiero potem wykonuj aktualizację. Nie łącz migracji, zmiany wersji PHP i aktualizacji Drupala w jednym kroku. Kopia plików i bazy danych pozwala cofnąć zmianę, jeśli test zakończy się niepowodzeniem.
Stary cache po przeniesieniu strony
Po migracji Drupal może wyświetlać dane zapisane przed przeniesieniem. Dotyczy to między innymi treści, konfiguracji i elementów zależnych od cache. Wyczyść cache Drupala po zakończeniu importu bazy danych i sprawdź stronę w nowej sesji przeglądarki.
Objawy
- strona pokazuje wcześniejszą wersję treści,
- zmiana konfiguracji nie jest widoczna,
- różni użytkownicy widzą różne wyniki.
Jeśli problem występuje tylko w jednej przeglądarce, wyczyść także jej cache. Następnie sprawdź stronę po ponownym załadowaniu kilku adresów.
Nieprawidłowe clean URLs i konfiguracja serwera
Clean URLs to przyjazne adresy stron Drupala. Po zmianie serwera ich działanie zależy także od konfiguracji serwera WWW. Błędna konfiguracja może sprawić, że strona główna działa, ale adresy podstron zwracają błąd.
Jak diagnozować
- Otwórz stronę główną oraz kilka bezpośrednich adresów podstron.
- Sprawdź, czy adresy z włączonymi clean URLs prowadzą do właściwych treści.
- Jeśli podstrony nie działają, sprawdź reguły serwera WWW oraz konfigurację przekazywania żądań do Drupala.
Nieudane zadania cron
Cron wykonuje cykliczne zadania Drupala. Po migracji zadania mogą nadal wskazywać stare środowisko albo nie mieć dostępu do nowej instalacji.
Objawy
- zadania cykliczne nie wykonują się,
- cache lub dane używane przez stronę nie są odświeżane,
- w panelu pojawiają się zaległe zadania.
Po uruchomieniu kopii na nowym hostingu wykonaj cron i sprawdź wynik. Zweryfikuj, czy zadanie korzysta z nowej lokalizacji Drupala, właściwego środowiska i poprawnych uprawnień.
Przed zmianą DNS i wyłączeniem starego hostingu
Nie zmieniaj DNS, dopóki kopia na nowym hostingu nie przejdzie testów. Przed przełączeniem sprawdź pliki, bazę danych, ścieżki w settings.php, zależności Composer, wersje środowiska, cache, clean URLs i cron.
- zachowaj kopię starej strony,
- przetestuj stronę na nowym hostingu przed zmianą DNS,
- sprawdź działanie podstron, plików i funkcji zależnych od bazy danych,
- po zmianie DNS obserwuj działanie nowej instalacji,
- stary hosting wyłącz dopiero po potwierdzeniu, że nowa kopia działa poprawnie.
Najbezpieczniejsza kolejność to: kompletna kopia, odtworzenie plików i bazy danych, dopasowanie konfiguracji, testy na nowym serwerze, dopiero potem zmiana DNS. Przy błędzie wróć do ostatniej działającej kopii zamiast wykonywać kilka niepowiązanych zmian jednocześnie.