Wp-config database settings – jak poprawnie skonfigurować bazę?

Ustawienia bazy danych WordPress znajdują się w pliku wp-config.php, w głównym katalogu instalacji. Aby strona połączyła się z bazą, wartości DB_NAME, DB_USER, DB_PASSWORD i DB_HOST muszą odpowiadać danym utworzonym na serwerze.

Gdzie znaleźć plik wp-config.php?

Plik wp-config.php znajduje się zwykle w katalogu głównym WordPressa, czyli w folderze zawierającym między innymi katalogi wp-admin, wp-content i wp-includes. Otworzysz go przez FTP, sFTP albo menedżer plików dostępny w panelu hostingowym.

Przed edycją pobierz plik na komputer i zachowaj jego kopię. Błędny wpis może spowodować niedostępność strony lub błąd połączenia z bazą. Do edycji użyj czystego edytora tekstowego, na przykład Notepad++, Visual Studio Code albo Sublime Text. Nie otwieraj pliku w programie Word, ponieważ może zmienić formatowanie i kodowanie znaków.

Przed zapisaniem zmian wykonaj kopię pliku wp-config.php. Jeśli strona przestanie działać, przywrócenie poprzedniej wersji pozwoli szybko cofnąć błędną konfigurację.

Jakie parametry zawiera sekcja Database settings?

W pliku wyszukaj sekcję oznaczoną komentarzem Database settings albo MySQL settings. WordPress korzysta zwykle z MySQL lub MariaDB, a dane potrzebne do połączenia otrzymasz w panelu hostingu. Część informacji może być też widoczna w konfiguracji phpMyAdmin, jednak samo phpMyAdmin nie zawsze pokazuje hasło użytkownika.

Przykładowa sekcja może wyglądać tak:

<?php
define( 'DB_NAME', 'nazwa_bazy_danych' );
define( 'DB_USER', 'nazwa_uzytkownika' );
define( 'DB_PASSWORD', 'haslo_do_bazy' );
define( 'DB_HOST', 'localhost' );
define( 'DB_CHARSET', 'utf8mb4' );

Podmień wyłącznie wartości znajdujące się między apostrofami. Nie usuwaj przecinków, nawiasów ani średników. Hasło traktuj jako dane poufne i nie publikuj całego pliku w zgłoszeniu na forum lub w wiadomości do osoby trzeciej.

DB_CHARSET zwykle pozostaje ustawione jako utf8mb4. Ten zestaw znaków obsługuje między innymi polskie znaki i symbole używane we współczesnych treściach. Zmieniaj go tylko wtedy, gdy wymaga tego konkretna konfiguracja serwera lub migracja bazy.

Jak zedytować wp-config.php krok po kroku?

Zmiana danych połączenia wymaga dostępu do plików strony oraz aktualnych danych bazy z panelu hostingowego:

1. Pobierz wp-config.php przez FTP lub otwórz go w menedżerze plików hostingu.
2. Utwórz kopię oryginalnego pliku przed wprowadzeniem zmian.
3. Znajdź sekcję Database settings i sprawdź wartości DB_NAME, DB_USER, DB_PASSWORD oraz DB_HOST.
4. Zastąp stare dane nowymi, zachowując apostrofy i składnię funkcji define().
5. Zapisz plik w edytorze tekstowym i wgraj go z powrotem na serwer, jeśli edytowałeś kopię lokalną.
6. Otwórz stronę oraz panel administracyjny WordPressa i sprawdź, czy działają poprawnie.

Jeżeli zmieniasz hasło użytkownika bazy w panelu hostingu, zaktualizuj je także w DB_PASSWORD. Samo zmienienie wartości w pliku nie utworzy nowego użytkownika ani nie nada mu uprawnień.

Dlaczego DB_HOST nie zawsze oznacza localhost?

Wartość localhost jest często używana, gdy serwer WWW i baza działają na tej samej maszynie. Nie jest to jednak reguła. Hosting może wymagać konkretnej nazwy hosta, adresu serwera albo portu podanego w panelu usługi.

W środowiskach chmurowych i przy rozdzieleniu serwera aplikacji od serwera bazy DB_HOST może mieć postać nazwy domenowej, na przykład mysql.example-host.net. Nie wpisuj automatycznie localhost tylko dlatego, że znajduje się w przykładowej konfiguracji. Użyj wartości przekazanej przez dostawcę hostingu. Informacje o wersji MySQL lub MariaDB mogą mieć znaczenie, ale nazwa hosta zależy przede wszystkim od konkretnej usługi.

Najczęstsze błędy po zmianie ustawień

Komunikat Error establishing a database connection oznacza, że WordPress nie może nawiązać połączenia z bazą. Sprawdź w pierwszej kolejności:

• Niepoprawne hasło – porównaj DB_PASSWORD z aktualnym hasłem użytkownika bazy. Zwróć uwagę na spacje i znaki specjalne.
• Błędna nazwa bazy – sprawdź, czy DB_NAME wskazuje istniejącą bazę, a nie tylko nazwę projektu lub folderu.
• Niepoprawny użytkownik – upewnij się, że DB_USER ma dostęp do wskazanej bazy.
• Nieprawidłowy host – zastąp localhost adresem wymaganym przez hosting, jeśli baza działa na innym serwerze.
• Błędy kodowania – przy problemach z polskimi znakami sprawdź, czy DB_CHARSET ma wartość zgodną z konfiguracją, najczęściej utf8mb4.

Po każdej zmianie testuj stronę w przeglądarce. Jeśli nadal pojawia się błąd, porównaj wszystkie cztery dane z informacjami w panelu hostingu, sprawdź status serwera bazy i w razie potrzeby skontaktuj się z pomocą techniczną dostawcy. Gdy edycja spowoduje błąd składni, przywróć kopię pliku i ponów zmianę ostrożniej.