Strona WordPress nie działa po migracji – jak zdiagnozować

Wprowadzenie – Typowe problemy po migracji strony WordPress

Migracja strony WordPress na nowy serwer to jedno z najczęstszych źródeł problemów technicznych. Nawet doświadczeni administratorzy mogą napotkać trudności, które uniemożliwiają prawidłowe działanie witryny po przeniesieniu. Zrozumienie najczęstszych przyczyn problemów ma znaczenie dla szybkiego przywrócenia działania strony.

Problemy po migracji mogą objawiać się na wiele sposobów – od białego ekranu śmierci, przez błędy połączenia z bazą danych, aż po nieprawidłowe wyświetlanie treści czy niedziałające linki. W artykule omówimy systematyczne podejście do diagnozowania i naprawy wszystkich typowych problemów pomigracyjnych.

Kluczem do skutecznego rozwiązywania problemów jest metodyczne sprawdzanie poszczególnych elementów systemu, zaczynając od najbardziej prawdopodobnych przyczyn. Dzięki temu zaoszczędzisz czas i szybko zidentyfikujesz źródło problemu.

Sprawdzenie poprawności pliku wp-config.php

Plik wp-config.php to serce konfiguracji WordPress i najczęstsze miejsce występowania błędów po migracji. Zawiera wszystkie krytyczne ustawienia, które muszą być dostosowane do nowego środowiska serwera.

Weryfikacja danych dostępowych do bazy danych

Pierwszym krokiem jest sprawdzenie, czy dane logowania do bazy danych są poprawne. Nowy hosting zazwyczaj wymaga zmiany następujących parametrów:

• DB_NAME – nazwa bazy danych musi odpowiadać bazie utworzonej na nowym serwerze
• DB_USER – użytkownik bazy danych z odpowiednimi uprawnieniami
• DB_PASSWORD – hasło użytkownika bazy danych
• DB_HOST – adres serwera bazy danych (często localhost, ale może być inny)

Sprawdzenie prefiksu tabel

Prefiks tabel musi zgadzać się z tym, który został użyty podczas importu bazy danych. Standardowo WordPress używa prefiksu wp_, jednak wiele instalacji wykorzystuje niestandardowe prefiksy ze względów bezpieczeństwa.

Weryfikacja kluczy bezpieczeństwa

Klucze bezpieczeństwa (Authentication Keys and Salts) powinny pozostać niezmienione podczas migracji, chyba że świadomie chcesz wylogować wszystkich użytkowników. Zmiana kluczy unieważni wszystkie sesje i ciasteczka.

Włączenie trybu debugowania

Tymczasowe włączenie trybu debugowania pomoże zidentyfikować dokładne przyczyny błędów. Pamiętaj jednak, aby wyłączyć debugowanie na stronie produkcyjnej po zakończeniu diagnostyki.

Weryfikacja połączenia z bazą danych

Błąd połączenia z bazą danych to jeden z najczęstszych problemów po migracji. Może wynikać z wielu przyczyn, od nieprawidłowych danych logowania po problemy z samym serwerem bazy danych.

Testowanie połączenia

Zanim zaczniesz modyfikować pliki, sprawdź czy w ogóle możesz połączyć się z bazą danych. Możesz to zrobić poprzez panel administracyjny hostingu (phpMyAdmin) lub narzędzia dostarczane przez dostawcę usługi.

Sprawdzenie uprawnień użytkownika bazy danych

Użytkownik bazy danych musi posiadać odpowiednie uprawnienia do wszystkich operacji wymaganych przez WordPress:

• SELECT – odczyt danych
• INSERT – dodawanie nowych rekordów
• UPDATE – aktualizacja istniejących danych
• DELETE – usuwanie rekordów
• CREATE – tworzenie nowych tabel
• ALTER – modyfikacja struktury tabel
• DROP – usuwanie tabel

Weryfikacja importu bazy danych

Sprawdź czy wszystkie tabele zostały poprawnie zaimportowane. W phpMyAdmin powinny być widoczne wszystkie tabele WordPress, takie jak: wp_posts, wp_options, wp_users, wp_postmeta, wp_comments i inne.

Naprawa uszkodzonych tabel

Jeśli podczas importu wystąpiły błędy, niektóre tabele mogą być uszkodzone. Większość paneli hostingowych oferuje opcję naprawy tabel bezpośrednio z phpMyAdmin lub poprzez narzędzia serwisowe.

Analiza problemów ze ścieżkami i URL-ami

Nieprawidłowe adresy URL to jedna z głównych przyczyn niedziałających stron po migracji. WordPress przechowuje absolutne ścieżki URL w bazie danych, co wymaga ich aktualizacji przy zmianie domeny lub struktury katalogów.

Sprawdzenie opcji siteurl i home

W tabeli wp_options przechowywane są dwie kluczowe wartości:

• siteurl – adres instalacji WordPress (gdzie znajdują się pliki)
• home – adres strony głównej (co użytkownicy widzą w przeglądarce)

Obie wartości muszą odpowiadać nowemu adresowi strony, włącznie z protokołem (http lub https).

Aktualizacja linków w treściach

WordPress przechowuje pełne adresy URL w treściach postów, stron i w ustawieniach wtyczek. Po zmianie domeny wszystkie te linki muszą zostać zaktualizowane. Można to zrobić za pomocą specjalistycznych narzędzi do wyszukiwania i zamiany w bazie danych.

Weryfikacja pliku .htaccess

Plik .htaccess może zawierać reguły specyficzne dla poprzedniego serwera, które nie działają na nowym. Sprawdź czy reguły przepisywania URL są kompatybilne z konfiguracją nowego serwera Apache lub nginx.

Problemy z trailing slash

Niespójne użycie ukośnika na końcu adresów URL może powodować problemy z przekierowaniami. Upewnij się, że konfiguracja WordPress i serwera są spójne w tym zakresie.

Diagnostyka uprawnień plików i folderów

Nieprawidłowe uprawnienia plików mogą całkowicie zablokować działanie strony. Różne serwery mogą wymagać różnych ustawień uprawnień, szczególnie w środowiskach współdzielonych.

Standardowe uprawnienia WordPress

WordPress zaleca następujące uprawnienia dla plików i katalogów:

• Katalogi – 755 (rwxr-xr-x) – właściciel może czytać, pisać i wykonywać; inni tylko czytać i wykonywać
• Pliki – 644 (rw-r--r--) – właściciel może czytać i pisać; inni tylko czytać
• wp-config.php – 600 lub 640 – ograniczony dostęp ze względów bezpieczeństwa
• wp-content/uploads – 755 z możliwością zapisu dla serwera www

Weryfikacja właściciela plików

Na serwerach Linux pliki muszą należeć do odpowiedniego użytkownika i grupy. Zazwyczaj jest to użytkownik www-data lub apache, ale może się różnić w zależności od konfiguracji hostingu.

Problemy z katalogiem uploads

Katalog wp-content/uploads musi być zapisywalny dla serwera www, aby można było przesyłać nowe pliki multimedialne. Sprawdź czy uprawnienia pozwalają na zapis i tworzenie nowych podkatalogów.

Weryfikacja plików tymczasowych

WordPress potrzebuje możliwości tworzenia plików tymczasowych do aktualizacji i instalacji wtyczek. Upewnij się, że katalog tmp lub wp-content jest dostępny do zapisu.

Sprawdzenie kompatybilności wersji PHP

Różnice w wersjach PHP między starym a nowym serwerem mogą powodować poważne problemy. Nowsze wersje PHP wprowadzają zmiany, które mogą być niekompatybilne ze starszymi wtyczkami lub motywami.

Sprawdzenie aktualnej wersji PHP

Pierwszym krokiem jest ustalenie, jaka wersja PHP działa na nowym serwerze. Możesz to zrobić poprzez panel hostingowy lub tworząc prosty plik informacyjny. Porównaj wersję z wymaganiami WordPress i używanych wtyczek.

Typowe problemy kompatybilności

Najczęstsze problemy związane z wersjami PHP obejmują:

• Przestarzałe funkcje – funkcje usunięte w nowszych wersjach PHP
• Zmieniona składnia – różnice w sposobie deklarowania zmiennych lub funkcji
• Nowe wymagania typów – ścisłe typowanie w PHP 7 i nowszych
• Zmienione zachowanie funkcji – niektóre funkcje zwracają inne wartości

Aktualizacja wtyczek i motywów

Przed zmianą wersji PHP zaleca się aktualizację wszystkich wtyczek i motywów do najnowszych wersji. Deweloperzy zazwyczaj dostosowują swój kod do nowych wersji PHP.

Testowanie w środowisku staging

Jeśli to możliwe, przetestuj stronę w środowisku testowym z nową wersją PHP przed migracją produkcyjną. Pozwoli to wykryć problemy zanim wpłyną na działającą stronę.

Testowanie funkcjonalności po migracji

Systematyczne testowanie wszystkich funkcji strony ma znaczenie dla wykrycia ukrytych problemów. Niektóre błędy mogą nie być widoczne od razu i ujawnią się dopiero podczas normalnego użytkowania.

Checklista testów podstawowych

Po zakończeniu migracji przeprowadź następujące testy:

• Strona główna – czy ładuje się poprawnie ze wszystkimi elementami
• Podstrony – sprawdź kilka różnych stron i postów
• Menu nawigacyjne – czy wszystkie linki działają prawidłowo
• Wyszukiwarka – czy zwraca poprawne wyniki
• Formularze kontaktowe – czy wiadomości są wysyłane
• Panel administracyjny – czy można się zalogować i zarządzać treścią

Testowanie mediów

Sprawdź czy wszystkie obrazy i pliki multimedialne są dostępne. Przejrzyj galerię mediów w panelu administracyjnym i sprawdź czy miniaturki są generowane poprawnie.

Weryfikacja wtyczek

Przetestuj działanie wszystkich aktywnych wtyczek, szczególnie tych krytycznych dla funkcjonowania strony, takich jak:

• Wtyczki e-commerce (WooCommerce)
• Wtyczki formularzy kontaktowych
• Wtyczki cache
• Wtyczki SEO
• Wtyczki bezpieczeństwa

Testowanie na różnych urządzeniach

Sprawdź stronę na różnych przeglądarkach i urządzeniach mobilnych. Problemy z migracją mogą czasem wpływać na responsywność lub wyświetlanie na konkretnych platformach.

Naprawa uszkodzonych linków w bazie danych

Serializowane dane w bazie WordPress wymagają specjalnego podejścia podczas aktualizacji URL-i. Zwykłe wyszukanie i zamiana może uszkodzić dane, ponieważ WordPress przechowuje informacje o długości ciągów tekstowych.

Problem z serializowanymi danymi

WordPress używa serializacji PHP do przechowywania złożonych danych w bazie. Każdy serializowany ciąg zawiera informację o swojej długości. Zmiana URL bez aktualizacji tej informacji powoduje uszkodzenie danych.

Bezpieczne narzędzia do zamiany URL

Istnieją sprawdzone narzędzia do bezpiecznej aktualizacji URL-i w bazie WordPress:

• WP-CLI – polecenie search-replace z opcją --all-tables
• Better Search Replace – wtyczka z obsługą serializowanych danych
• Search Replace DB – skrypt PHP do użycia na serwerze
• Velvet Blues Update URLs – prosta wtyczka do podstawowych zmian

Procedura zamiany URL

Podczas zamiany URL-i pamiętaj o następujących zasadach:

• Wykonaj kopię zapasową – zawsze przed jakimikolwiek zmianami w bazie
• Zamień wszystkie warianty – http, https, z www i bez www
• Uwzględnij ścieżki – nie tylko domenę, ale też zmienione katalogi
• Przetestuj dokładnie – sprawdź różne elementy strony po zamianie

Weryfikacja po zamianie

Po aktualizacji URL-i sprawdź czy wszystkie elementy działają poprawnie. Zwróć szczególną uwagę na ustawienia wtyczek, widgety i niestandardowe pola, które często przechowują adresy URL.

Weryfikacja konfiguracji serwera

Różnice w konfiguracji serwera między środowiskami mogą powodować nieoczekiwane problemy. Każdy hosting ma swoją specyfikę, którą trzeba uwzględnić podczas migracji.

Moduły serwera Apache/nginx

Sprawdź czy na nowym serwerze są dostępne wszystkie wymagane moduły:

• mod_rewrite – niezbędny dla ładnych permalinków
• mod_headers – do ustawiania nagłówków HTTP
• mod_expires – dla cache przeglądarki
• mod_deflate – kompresja GZIP
• mod_ssl – obsługa HTTPS

Limity PHP

Różne hostingi mogą mieć różne limity PHP, które wpływają na działanie WordPress:

• memory_limit – limit pamięci (zalecane minimum 256M)
• max_execution_time – maksymalny czas wykonania skryptu
• upload_max_filesize – maksymalny rozmiar przesyłanych plików
• post_max_size – maksymalny rozmiar danych POST
• max_input_vars – maksymalna liczba zmiennych wejściowych

Konfiguracja HTTPS

Jeśli strona używa HTTPS, upewnij się że certyfikat SSL jest poprawnie skonfigurowany na nowym serwerze. Sprawdź czy przekierowania z HTTP na HTTPS działają prawidłowo.

Konfiguracja poczty

Sprawdź czy nowy serwer pozwala na wysyłanie wiadomości email. Wiele hostingów wymaga użycia SMTP zamiast wbudowanej funkcji mail PHP. Przetestuj formularze kontaktowe i powiadomienia WordPress.

Podsumowanie – Skuteczna migracja WordPress bez problemów

Systematyczne podejście do diagnozowania problemów po migracji jest kluczem do szybkiego przywrócenia działania strony. Zamiast losowo szukać przyczyn, postępuj metodycznie przez wszystkie potencjalne źródła problemów.

Checklista diagnostyczna

Podsumowując, przy każdej niedziałającej stronie po migracji sprawdź kolejno:

• wp-config.php – dane bazy danych, prefiksy tabel, klucze bezpieczeństwa
• Baza danych – połączenie, uprawnienia, kompletność tabel
• URL-e – siteurl, home, linki w treściach
• Uprawnienia – pliki (644), katalogi (755), właściciel
• PHP – wersja, kompatybilność, limity
• Serwer – moduły, konfiguracja, HTTPS, poczta

Zapobieganie problemom

Najlepszą metodą radzenia sobie z problemami migracji jest ich unikanie:

• Testuj w środowisku staging – przed migracją produkcyjną
• Używaj sprawdzonych narzędzi – wtyczki migracyjne automatyzują wiele kroków
• Dokumentuj konfigurację – zachowaj informacje o ustawieniach starego serwera
• Twórz kopie zapasowe – przed i po migracji
• Planuj okno serwisowe – miej czas na rozwiązanie ewentualnych problemów

Kiedy szukać pomocy profesjonalnej

Niektóre problemy mogą wymagać specjalistycznej wiedzy. Rozważ kontakt z profesjonalistą gdy:

• Problem dotyczy niestandardowej konfiguracji serwera
• Strona używa złożonych integracji z zewnętrznymi systemami
• Dane w bazie zostały uszkodzone podczas migracji
• Brakuje czasu na samodzielną diagnostykę

Pamiętaj, że dobrze przeprowadzona migracja WordPress to kwestia starannego przygotowania i metodycznego podejścia. Większość problemów można rozwiązać samodzielnie, pod warunkiem że wiesz gdzie szukać ich przyczyn.