Gdy WordPress na localhost nie działa, najpierw sprawdź usługę MySQL w XAMPP lub WAMP. W większości przypadków błąd połączenia z bazą danych wynika z jej wyłączenia albo z niepoprawnych danych w pliku wp-config.php, a nie z awarii samego WordPressa.
Jak szybko rozpoznać przyczynę?
Objaw widoczny w przeglądarce nie zawsze wskazuje dokładne źródło problemu. Poniższa tabela pomaga wybrać pierwszy krok diagnostyczny:
| Objaw | Najczęstsza przyczyna | Pierwszy krok |
|---|---|---|
| WordPress wyświetla błąd połączenia z bazą danych | Wyłączona usługa MySQL albo błędne dane w konfiguracji | Sprawdź MySQL w panelu XAMPP lub WAMP |
| Apache działa, ale MySQL nie chce się uruchomić | Konflikt portu, zatrzymana usługa albo problem z plikami bazy | Odczytaj komunikat w panelu i sprawdź log MySQL |
| phpMyAdmin nie otwiera się lub nie widzi bazy | MySQL nie działa albo baza nie została utworzona | Uruchom MySQL i sprawdź listę baz w phpMyAdmin |
| MySQL działa, ale WordPress nadal zgłasza błąd | Niezgodność wartości w pliku wp-config.php | Porównaj DB_NAME, DB_USER, DB_PASSWORD i DB_HOST |
WordPress localhost nie działa – naprawa w XAMPP lub WAMP
Na lokalnym komputerze serwer Apache i baza danych MySQL są uruchamiane niezależnie. Samo włączenie Apache nie wystarczy, ponieważ WordPress potrzebuje jeszcze aktywnej bazy danych.
Przed zmianami wykonaj kopię zapasową folderu projektu oraz bazy danych. Skopiuj katalog instalacji WordPressa, na przykład C:\xampp\htdocs\wordpress, a bazę wyeksportuj z phpMyAdmin. Dzięki temu łatwiej cofniesz błędną zmianę.
Wykonaj następujące czynności:
- Otwórz XAMPP Control Panel albo panel używanego środowiska lokalnego.
- Uruchom Apache oraz MySQL, klikając przy nich przycisk „Start”.
- Sprawdź, czy obok obu usług pojawił się zielony status.
- Otwórz phpMyAdmin i potwierdź, że baza używana przez WordPress znajduje się na liście.
- Odśwież stronę lokalną, na przykład pod adresem http://localhost/wordpress/.
Jeśli Apache działa, a MySQL nie, przyczyna błędu leży najpewniej po stronie bazy. Gdy MySQL nie uruchamia się mimo kliknięcia „Start”, sprawdź komunikat w dolnej części panelu oraz logi. Częstym powodem jest konflikt portu z inną aplikacją. Zdarza się też, że port jest zajęty przez drugi proces serwera lub narzędzie działające w tle.
Jak sprawdzić plik wp-config.php?
Plik wp-config.php znajduje się w głównym folderze instalacji WordPressa, zwykle w htdocs. Zawiera parametry, na podstawie których WordPress łączy się z bazą danych. Otwórz go w edytorze tekstu i sprawdź cztery wartości.
- Znajdź plik wp-config.php w folderze projektu.
- Porównaj wartość DB_NAME z nazwą bazy widoczną w phpMyAdmin.
- Sprawdź DB_USER i DB_PASSWORD, czyli login oraz hasło użytkownika bazy.
- Zweryfikuj DB_HOST. W typowej instalacji XAMPP używa się wartości localhost.
Domyślna konfiguracja lokalnego XAMPP może wyglądać tak:
define( 'DB_NAME', 'wordpress' );
define( 'DB_USER', 'root' );
define( 'DB_PASSWORD', '' );
define( 'DB_HOST', 'localhost' );Nazwa wordpress jest tylko przykładem i musi odpowiadać rzeczywistej nazwie bazy. W podstawowej konfiguracji XAMPP użytkownik często nazywa się root, a hasło pozostaje puste, ale ustawienia mogły zostać zmienione podczas instalacji lub późniejszej konfiguracji. Nie kopiuj tych wartości bez sprawdzenia ich w swoim środowisku.
DB_HOST wskazuje adres serwera bazy danych. Na localhost zwykle jest to localhost albo 127.0.0.1. Na zdalnym serwerze może być wymagany inny adres, lecz ten przypadek dotyczy hostingu, a nie lokalnej instalacji.
Co zrobić, gdy MySQL działa, ale WordPress nadal nie łączy się z bazą?
Najpierw zaloguj się do phpMyAdmin i sprawdź, czy widzisz bazę wskazaną w DB_NAME. Jeśli jej brakuje, WordPress nie będzie miał z czym się połączyć. Utwórz bazę o właściwej nazwie albo popraw wpis w pliku konfiguracyjnym.
Jeżeli phpMyAdmin działa, ale pojawia się komunikat o odmowie dostępu, sprawdź login i hasło. W lokalnym środowisku może to oznaczać, że użytkownik root ma ustawione hasło, którego nie ma w wp-config.php.
Po każdej zmianie zapisz plik i odśwież stronę. Nie zmieniaj kilku parametrów naraz, bo utrudni to ustalenie, która poprawka rozwiązała problem.
Zaawansowana diagnostyka bazy
Jeśli usługi działają, dane są poprawne, a błąd nadal występuje, sprawdź komunikaty w logach XAMPP. Mogą wskazać konflikt portu, uszkodzenie tabel lub problem z uruchomieniem serwera MySQL.
WordPress ma też narzędzie do naprawy bazy. Przed jego użyciem wykonaj kopię, a następnie tymczasowo dodaj w wp-config.php:
define( 'WP_ALLOW_REPAIR', true );Potem otwórz adres:
http://localhost/wordpress/wp-admin/maint/repair.phpZastąp wordpress nazwą folderu swojej instalacji. Po zakończeniu naprawy usuń dodaną stałą z pliku konfiguracyjnego. Pozostawienie tego narzędzia dostępnego nie jest potrzebne po zakończeniu prac.
Możesz też włączyć logowanie błędów WordPressa, dodając lub zmieniając ustawienia WP_DEBUG i WP_DEBUG_LOG. Log zostanie zapisany w folderze wp-content. Traktuj go jako wskazówkę diagnostyczną, a nie jako powód do przypadkowej edycji plików systemowych.
Krótka kontrola po naprawie
Po przywróceniu działania sprawdź jeszcze raz najważniejsze elementy:
- Usługi Apache i MySQL mają status uruchomiony.
- Baza WordPressa jest widoczna w phpMyAdmin.
- Wartości DB_NAME, DB_USER, DB_PASSWORD i DB_HOST są zgodne z lokalną konfiguracją.
- Wykonano kopię folderu projektu oraz eksport bazy.
- Strona główna i panel administracyjny otwierają się bez komunikatu o błędzie.
W przypadku localhost nie zaczynaj od zmian w plikach WordPressa. Najpierw uruchom MySQL w panelu XAMPP lub WAMP, sprawdź bazę w phpMyAdmin, a dopiero później weryfikuj wp-config.php. Taka kolejność rozwiązuje dużą część problemów bez reinstalowania WordPressa i bez utraty danych.
