wp-config.php to główny plik konfiguracyjny WordPressa. Łączy instalację z bazą danych i określa część ustawień środowiska, dlatego przed każdą zmianą trzeba wykonać kopię zapasową oraz zapisać plik jako UTF-8 bez BOM. Błąd składni może zatrzymać całą witrynę.
Czym jest plik wp-config.php?
Plik wp-config.php znajduje się zwykle w katalogu głównym instalacji WordPressa, obok folderów wp-admin, wp-content i wp-includes. WordPress odczytuje go podczas uruchamiania, aby ustalić, z jaką bazą danych ma się połączyć i w jakim środowisku działa.
W pliku znajdują się między innymi dane dostępowe do bazy, klucze bezpieczeństwa, prefiks tabel oraz stałe sterujące debugowaniem, pamięcią PHP czy dostępem do edytora plików. Podczas instalacji WordPress zwykle tworzy go automatycznie na podstawie podanych danych. W paczce instalacyjnej znajduje się natomiast plik wp-config-sample.php, który można wykorzystać jako wzór.
Większość właścicieli stron nie musi edytować tego pliku na co dzień. Jeśli jednak zmieniasz hosting, przywracasz bazę z kopii, diagnozujesz błąd albo konfigurujesz środowisko testowe, modyfikacja może być potrzebna.
Co sprawdzić przed edycją?
Plik jest ładowany przy każdym uruchomieniu WordPressa. Brak średnika, niezamknięty cudzysłów lub przypadkowy znak przed otwierającym tagiem PHP może wywołać błąd krytyczny albo tak zwany White Screen of Death, czyli biały ekran śmierci.
Przed rozpoczęciem przygotuj:
- Kopię pliku wp-config.php zapisaną poza serwerem.
- Kopię bazy danych oraz, najlepiej, całej witryny.
- Możliwość szybkiego przywrócenia poprzedniej wersji pliku.
- Edytor kodu obsługujący zapis jako UTF-8 bez BOM.
- Środowisko testowe, jeśli zmiana nie jest pilna.
Nie używaj Worda ani podobnego procesora tekstu. Mogą one dodać formatowanie, zmienić cudzysłowy albo zapisać plik w niewłaściwym kodowaniu. Zwykły Notatnik również nie daje takiej kontroli jak edytor kodu, na przykład Notepad++ lub Visual Studio Code.
Ostrzeżenie: nie dodawaj pustych linii, spacji ani znaków przed <?php i nie dopisuj zamykającego tagu ?> na końcu pliku. Takie znaki mogą spowodować błąd Cannot modify header information – headers already sent by, zwłaszcza gdy plik został zapisany z BOM.
Jak edytować wp-config.php krok po kroku?
Do pliku możesz uzyskać dostęp przez FTP, SFTP, SSH albo menedżer plików w panelu hostingu, takim jak DirectAdmin. Nazwy folderów mogą się różnić, ale plik powinien znajdować się w katalogu konkretnej instalacji WordPressa.
- Zaloguj się do panelu hostingu albo klienta FTP/SFTP.
- Otwórz katalog główny właściwej instalacji WordPressa.
- Pobierz plik
wp-config.phpna komputer i zachowaj jego kopię. - Otwórz plik w edytorze kodu, nie w procesorze tekstu.
- Wprowadź jedną, zaplanowaną zmianę. Nie usuwaj istniejących wpisów, jeśli nie wiesz, za co odpowiadają.
- Sprawdź średniki, apostrofy, cudzysłowy i nawiasy oraz upewnij się, że kodowanie to UTF-8 bez BOM.
- Zapisz plik i prześlij go na serwer, potwierdzając nadpisanie poprzedniej wersji.
- Otwórz stronę oraz panel administracyjny i sprawdź, czy działają poprawnie.
Jeśli edytor w panelu hostingu pozwala zmieniać plik bezpośrednio na serwerze, również najpierw pobierz kopię. Wygoda takiej edycji nie zmienia ryzyka związanego z błędnym kodem.
Jakie ustawienia można zmienić?
Wpisy w pliku mają najczęściej postać stałych definiowanych przez define(), na przykład define( 'WP_DEBUG', false );. Z kolei $table_prefix jest zmienną PHP. Rozróżnienie ma znaczenie, ponieważ nie należy zmieniać składni ani nazw stałych przypadkowo.
| Stała lub zmienna | Przykładowa wartość | Opis działania |
|---|---|---|
DB_NAME |
'nazwa_bazy' |
Określa nazwę bazy danych używanej przez WordPress. |
WP_DEBUG |
true lub false |
Włącza lub wyłącza tryb diagnostyczny. |
WP_MEMORY_LIMIT |
'256M' |
Ustawia limit pamięci dla działania WordPressa. |
DISALLOW_FILE_EDIT |
true |
Wyłącza edycję plików motywów i wtyczek w panelu. |
FORCE_SSL_ADMIN |
true |
Wymusza HTTPS podczas logowania i pracy w panelu. |
Dane połączenia z bazą
Najbardziej krytyczne wpisy to DB_NAME, DB_USER, DB_PASSWORD i DB_HOST. Zmieniaj je tylko wtedy, gdy znasz aktualne dane z panelu hostingu lub bazy danych.
define( 'DB_NAME', 'nazwa_bazy' );
define( 'DB_USER', 'uzytkownik_bazy' );
define( 'DB_PASSWORD', 'haslo_bazy' );
define( 'DB_HOST', 'localhost' );Błędne dane powodują komunikat o problemie z połączeniem z bazą. Nie publikuj zawartości pliku, ponieważ może zawierać hasło do bazy i inne dane wrażliwe.
Debugowanie i pamięć
Na środowisku testowym możesz włączyć diagnostykę:
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );Taki zapis kieruje błędy do logu zamiast wyświetlać je odwiedzającym. Po zakończeniu diagnozy wyłącz debugowanie i sprawdź, czy plik logu nie jest publicznie dostępny.
Przy błędach wyczerpania pamięci można czasem zwiększyć limit:
define( 'WP_MEMORY_LIMIT', '256M' );Nie rozwiązuje to każdej przyczyny problemu. Nadmierne zużycie pamięci może wynikać z wtyczki, motywu, importu danych albo ciężkich zapytań do bazy.
Bezpieczeństwo i prefiks tabel
DISALLOW_FILE_EDIT wyłącza edytor plików w panelu administracyjnym:
define( 'DISALLOW_FILE_EDIT', true );Zmniejsza to ryzyko, że osoba z przejętym kontem administratora zmieni kod motywu lub wtyczki bezpośrednio w kokpicie. Z kolei $table_prefix określa początek nazw tabel w bazie:
$table_prefix = 'wp_';Nie zmieniaj prefiksu w działającej instalacji bez przygotowania bazy i sprawdzenia wszystkich tabel. Sama zmiana nie wystarczy, ponieważ nazwy istniejących tabel również musiałyby zostać dostosowane.
W pliku znajdują się także klucze bezpieczeństwa, takie jak AUTH_KEY. Ich wymiana unieważnia aktywne ciasteczka, więc użytkownicy zostaną wylogowani. Nie wpisuj tam prostych haseł ani nie udostępniaj tych wartości osobom postronnym.
Co zrobić, gdy strona przestanie działać?
Jeśli po zapisaniu pliku pojawi się biały ekran, błąd 500 albo komunikat o błędzie składni, nie wprowadzaj kolejnych zmian w ciemno. Najpierw przywróć poprzednią kopię wp-config.php przez FTP, SFTP lub menedżer plików.
Jeżeli nie masz kopii, sprawdź ostatnią zmianę pod kątem brakującego średnika, cudzysłowu, nawiasu oraz znaków przed <?php. Zwróć też uwagę na kodowanie UTF-8 bez BOM. Przywrócenie pliku zwykle jest szybsze i bezpieczniejsze niż ręczne szukanie błędu na działającej stronie.
Gdy awaria dotyczy bazy, adresu domeny, sklepu, płatności albo migracji, a przywrócenie kopii nie pomaga, przerwij dalsze eksperymenty i poproś o pomoc administratora WordPressa lub hostingu.
Najważniejsza zasada jest prosta: edytuj wp-config.php tylko wtedy, gdy zmiana jest potrzebna, zawsze zachowaj kopię i zapisuj plik jako UTF-8 bez BOM.
