Jak możemy pomóc?

WordPress: „Błąd nawiązywania połączenia z bazą danych” - jak go naprawić?

Komunikat „Błąd nawiązywania połączenia z bazą danych” oznacza, że WordPress nie może połączyć się z bazą, w której przechowuje treść i ustawienia witryny. Sprawdź kolejno dane połączenia, istnienie bazy i dostęp użytkownika. Poniższa instrukcja pomoże ustalić przyczynę bez ponownej instalacji WordPressa.

Zanim zmienisz ustawienia

Ustal, kiedy strona przestała działać i czy wcześniej przenoszono ją na inny hosting, zmieniano hasło bazy lub edytowano pliki. Sprawdź stronę główną oraz /wp-admin/. Zanotuj dokładny komunikat i godzinę wystąpienia problemu.

Zachowaj kopię pliku wp-config.php poza publicznym katalogiem strony. Nie twórz pustej bazy w miejsce dotychczasowej i nie uruchamiaj ponownie instalacji WordPressa. Błąd połączenia nie oznacza, że zawartość witryny została usunięta.

1. Otwórz pliki właściwej witryny

Zaloguj się do DirectAdmin. W sekcji Pliki/FTP kliknij Menedżer Plików (1). Otwórz katalog instalacji WordPressa — zwykle domains/nazwa-domeny/public_html albo jego podkatalog. Jeśli domena korzysta z własnego katalogu, sprawdź właśnie ten katalog.

2. Otwórz wp-config.php

Odszukaj plik wp-config.php. Zaznacz go i wybierz Edytuj (2). Plik wp-config-sample.php jest tylko wzorem i jego zmiana nie naprawi połączenia działającej witryny.

3. Porównaj cztery ustawienia połączenia

W pliku odszukaj DB_NAME, DB_USER, DB_PASSWORD i DB_HOST (3). Nazwa bazy i użytkownika zwykle zawierają prefiks konta hostingowego. Po przeniesieniu strony prefiks może się zmienić, nawet jeśli pozostała część nazwy wygląda tak samo.

Nazwy i hasło na ilustracji są przykładami. Nie wklejaj ich do własnej konfiguracji. Jeżeli wartości są pobierane przez kod ze zmiennych środowiskowych lub innego pliku, sprawdź również to źródło.

4. Sprawdź, czy baza istnieje

Wróć do pulpitu DirectAdmin. W sekcji Bazy danych kliknij kafelek Bazy danych (4). Porównaj pełną nazwę z listy z wartością DB_NAME. Jeżeli masz kilka baz, nie wybieraj przypadkowej tylko dlatego, że ma podobną nazwę.

Brak właściwej bazy po migracji może oznaczać, że nie została jeszcze zaimportowana. W takim przypadku potrzebujesz kopii dotychczasowej bazy. Utworzenie nowej, pustej bazy nie przywróci wpisów ani ustawień strony.

5. Sprawdź użytkownika bazy

Kliknij Zarządzaj użytkownikami (5). Odszukaj nazwę wpisaną w DB_USER. Dla bazy działającej na tym samym hostingu zwróć uwagę na dozwolony host localhost. Sprawdzenie samej obecności użytkownika nie potwierdza jeszcze jego hasła ani uprawnień do konkretnej bazy.

Jeśli hasło zostało zmienione, zaktualizuj także DB_PASSWORD. Nie resetuj hasła w ciemno: z tego samego użytkownika mogą korzystać inne aplikacje. W razie wątpliwości poproś administratora witryny lub obsługę Hostido o sprawdzenie przypisania użytkownika do bazy i jego uprawnień.

6. Zapisz potwierdzoną poprawkę i sprawdź wynik

Zmieniaj tylko wartości, których błąd udało się potwierdzić. Zachowaj cudzysłowy lub apostrofy oraz składnię PHP. Zapisz plik, następnie ponownie otwórz stronę i kokpit. Jeżeli po edycji pojawił się inny błąd, przywróć kopię pliku i sprawdź poprawność zapisu.

Gdy dane są poprawne, a połączenie nadal nie działa, sprawdź log błędów PHP i skontaktuj się z obsługą Hostido. Podaj domenę, godzinę próby, nazwę bazy i dokładny komunikat. Nie dołączaj hasła ani całego pliku wp-config.php do publicznego zgłoszenia.

Jeśli WordPress łączy się z bazą, lecz zgłasza brak tabel albo proponuje instalację, jest to inna sytuacja. Sprawdź, czy wybrano właściwą bazę i czy prefiks tabel odpowiada konfiguracji witryny. Nie uruchamiaj instalacji na istniejących danych.