Jak skonfigurować plik wp-config.php? Poradnik krok po kroku

Plik wp-config.php zawiera dane potrzebne do uruchomienia WordPressa, między innymi ustawienia połączenia z bazą danych. Edytuj go wyłącznie w edytorze kodu i zawsze wykonaj kopię zapasową. Brak średnika, literówka albo błędny apostrof mogą spowodować błąd krytyczny i unieruchomić stronę.

Gdzie znajduje się wp-config.php?

Plik znajduje się zwykle w katalogu głównym instalacji WordPressa, obok folderów wp-admin, wp-content i wp-includes. Dostęp uzyskasz przez klienta FTP lub SFTP, menedżer plików w panelu hostingu albo SSH.

W paczce instalacyjnej WordPressa może nie być gotowego pliku wp-config.php. Podczas instalacji system tworzy go na podstawie pliku wp-config-sample.php. Przy ręcznej instalacji możesz skopiować plik przykładowy, uzupełnić dane i zapisać go pod właściwą nazwą.

Jak przygotować się do edycji?

Przed zmianą sprawdź, czy masz dostęp do serwera i znasz dane, które chcesz wpisać. Przygotuj też narzędzia potrzebne do bezpiecznej pracy:

Klient FTP lub SFTP – na przykład FileZilla, WinSCP albo menedżer plików hostingu.
Edytor kodu – na przykład Visual Studio Code lub Notepad++.
Dostęp do panelu hostingu – przydatny do sprawdzenia danych bazy i wykonania kopii.
Lokalna kopia pliku – zapisana poza serwerem przed rozpoczęciem zmian.

Nie używaj programu Word ani podobnego procesora tekstu. Nie zaleca się także zwykłego Notatnika, ponieważ może zmienić kodowanie lub dodać niewidoczne znaki. Zapisz plik jako zwykły tekst, najlepiej w kodowaniu UTF-8 bez BOM.

Ostrzeżenie: nie zostawiaj kopii o nazwie wp-config.php.bak, wp-config.php.old ani wp-config.php.txt w publicznym katalogu serwera. Taki plik może zostać pobrany przez przeglądarkę i ujawnić hasło do bazy danych.

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

Najbezpieczniejszy schemat obejmuje pobranie pliku, wykonanie kopii, zmianę jednej rzeczy naraz i sprawdzenie strony po zapisaniu.

Połącz się z serwerem przez FTP, SFTP lub menedżer plików i przejdź do katalogu głównego WordPressa.
Pobierz plik wp-config.php na komputer.
Utwórz jego kopię lokalną. Możesz także chwilowo zapisać kopię na serwerze pod inną nazwą, ale usuń ją natychmiast po zakończeniu pracy.
Otwórz oryginalny plik w edytorze kodu i zmień tylko wymagane linie.
Sprawdź składnię, zwłaszcza średniki, apostrofy i nawiasy. Nie usuwaj komentarza kończącego edycję, jeśli dodawana stała ma znaleźć się nad nim.
Zapisz plik i wgraj go na serwer, zastępując poprzednią wersję.
Otwórz stronę oraz panel administracyjny. Sprawdź logowanie, formularze i podstawowe funkcje.

Jeśli po wgraniu strona wyświetla biały ekran, błąd krytyczny albo komunikat o braku połączenia z bazą, nie wprowadzaj kolejnych zmian na ślepo. Przywróć poprzednią kopię pliku przez FTP lub menedżer plików. Gdy problem pozostanie, przyczyną może być także baza danych, wersja PHP albo inny plik.

Jakie parametry można zmieniać?

Najczęściej edytuje się dane bazy danych, tryb debugowania i wybrane ustawienia techniczne. Przykładowe wartości poniżej są tylko wzorami, więc zastąp je danymi otrzymanymi od hostingu.

Parametr	Opis	Przykład
`DB_NAME`	Nazwa bazy danych używanej przez WordPressa.	`define( 'DB_NAME', 'nazwa_bazy' );`
`DB_USER`	Użytkownik mający dostęp do bazy danych.	`define( 'DB_USER', 'uzytkownik' );`
`DB_PASSWORD`	Hasło użytkownika bazy danych.	`define( 'DB_PASSWORD', 'haslo' );`
`DB_HOST`	Host serwera bazy danych. Nie zawsze jest nim `localhost`.	`define( 'DB_HOST', 'localhost' );`
`WP_DEBUG`	Włącza lub wyłącza tryb diagnostyczny.	`define( 'WP_DEBUG', false );`
`WP_MEMORY_LIMIT`	Próbuje ustawić limit pamięci WordPressa, jeśli hosting na to pozwala.	`define( 'WP_MEMORY_LIMIT', '256M' );`

Podczas migracji strony lub zmiany danych bazy sprawdź przede wszystkim DB_NAME, DB_USER, DB_PASSWORD i DB_HOST. Błędna wartość któregoś z tych parametrów może wywołać komunikat o błędzie połączenia z bazą.

DB_CHARSET określa zestaw znaków. W istniejącej instalacji nie zmieniaj go bez wyraźnej potrzeby. Najczęściej spotyka się utf8mb4 lub utf8. Z kolei $table_prefix określa prefiks tabel, często ustawiony jako wp_. Zmiana prefiksu w działającej instalacji wymaga także zmian nazw tabel w bazie, dlatego nie należy wykonywać jej przypadkowo.

Do diagnozowania problemów możesz tymczasowo użyć konfiguracji:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

Błędy będą zapisywane w logu zamiast wyświetlane odwiedzającym. Po zakończeniu diagnozy wyłącz debugowanie, usuń zbędny log i sprawdź, czy plik nie jest publicznie dostępny. Na stronie produkcyjnej nie pokazuj użytkownikom szczegółów błędów.

Klucze bezpieczeństwa, takie jak AUTH_KEY, SECURE_AUTH_KEY i LOGGED_IN_KEY, powinny być długie i losowe. Ich ponowne wygenerowanie unieważni aktywne ciasteczka, więc użytkownicy będą musieli zalogować się ponownie.

Lista kontrolna przed zapisaniem

Przed wgraniem zmienionego pliku sprawdź następujące punkty:

Czy wykonałeś kopię zapasową pliku i, najlepiej, całej strony?
Czy użyłeś edytora kodu zamiast Worda lub procesora tekstu?
Czy plik zapisano jako zwykły tekst w kodowaniu UTF-8 bez BOM?
Czy każda nowa instrukcja ma średnik, poprawne apostrofy i nawiasy?
Czy kopia z hasłem do bazy nie pozostała w publicznym katalogu?
Czy po wgraniu sprawdziłeś stronę i panel administracyjny?

Uprawnienia pliku, na przykład 400 lub 440, mogą ograniczyć możliwość jego odczytu przez innych użytkowników serwera, ale właściwa wartość zależy od konfiguracji hostingu. Nie zmieniaj jej bez sprawdzenia, czy WordPress i proces PHP nadal mają wymagany dostęp.

Najbezpieczniejsza zasada jest prosta: kopia, jedna zmiana, test i dopiero następna modyfikacja. Jeśli po przywróceniu kopii strona nadal nie działa albo nie znasz danych dostępu do bazy, przerwij edycję i skorzystaj z pomocy administratora serwera.