Plik wp-config.php jest jednym z najważniejszych elementów WordPressa. Błąd w jednej linijce, brak średnika albo nieprawidłowy cudzysłów może wywołać błąd krytyczny, biały ekran i całkowite unieruchomienie strony. Przed edycją wykonaj kopię plików oraz bazy danych, a jeśli nie wiesz, co zmieniasz, skorzystaj z pomocy administratora.
Czym jest plik wp-config.php i gdzie go znaleźć?
wp-config.php to główny plik konfiguracyjny WordPressa. Zawiera między innymi dane połączenia z bazą danych, prefiks tabel, klucze bezpieczeństwa oraz ustawienia debugowania. Zwykle znajduje się w katalogu głównym instalacji, obok folderów wp-admin, wp-content i wp-includes.
Do pliku można dotrzeć przez menedżer plików w panelu hostingu, klienta FTP lub SFTP, a na serwerze VPS także przez SSH. Podczas ręcznej instalacji WordPressa punktem wyjścia może być plik wp-config-sample.php, który po uzupełnieniu zapisuje się jako wp-config.php.
Co przygotować przed edycją?
Nie edytuj pliku bez planu powrotu do poprzedniej wersji. Przed otwarciem wp-config.php przygotuj:
- Kopię plików – pobierz bieżący plik i zachowaj go lokalnie poza serwerem.
- Kopię bazy danych – wykonaj eksport, na przykład z użyciem narzędzia dostępnego w panelu hostingu.
- Środowisko testowe – jeśli zmiana nie jest pilna, sprawdź ją najpierw na kopii strony.
- Edytor kodu – użyj edytora obsługującego PHP i zapisz plik jako UTF-8 bez BOM.
- Plan awaryjny – zanotuj, które linie zmieniasz, aby łatwo je cofnąć.
Kopia samego pliku nie zastępuje kopii bazy danych. Edycja wp-config.php zmienia konfigurację aplikacji, natomiast dane wpisów, użytkowników i ustawień wtyczek znajdują się w bazie. Są to dwa różne obszary, dlatego przy zmianach dotyczących migracji lub adresu strony trzeba sprawdzić oba.
Jak uzyskać dostęp do pliku?
Wybierz metodę zależnie od rodzaju hostingu i swojego doświadczenia:
| Metoda | Poziom trudności | Zalecenie |
|---|---|---|
| Menedżer plików w panelu hostingu | Niski | Najwygodniejszy wybór na hostingu współdzielonym |
| FTP lub SFTP, na przykład FileZilla | Średni | Dobre rozwiązanie, gdy chcesz pobrać kopię i edytować ją lokalnie |
| SSH | Wyższy | Dla osób pracujących z terminalem i serwerami VPS |
Po odnalezieniu pliku najpierw pobierz jego kopię. Nie zapisuj kopii zapasowej w katalogu publicznym pod nazwą, którą można łatwo odgadnąć, ponieważ plik zawiera dane dostępowe do bazy.
Jak edytować wp-config.php krok po kroku?
- Otwórz katalog główny instalacji WordPressa i znajdź plik
wp-config.php. - Pobierz kopię pliku lub utwórz jej duplikat na serwerze poza publicznym katalogiem.
- Otwórz plik w edytorze kodu, nie w programie Microsoft Word ani innym procesorze tekstu.
- Znajdź konkretną stałą lub sekcję, którą chcesz zmienić, i modyfikuj tylko potrzebny fragment.
- Sprawdź składnię PHP, zwłaszcza apostrofy, nawiasy i średnik na końcu instrukcji.
- Zapisz plik w kodowaniu UTF-8 bez BOM i prześlij go na serwer, jeśli edytowałeś kopię lokalną.
- Otwórz stronę oraz panel administracyjny i sprawdź, czy działają poprawnie.
Nie usuwaj przypadkowo komentarzy i istniejących ustawień. Nowe stałe dodawaj w miejscu zgodnym z instrukcją dla danego parametru. Jedna zmiana naraz ułatwia znalezienie przyczyny problemu.
Jakie ustawienia najczęściej zmienia się w pliku?
Dane połączenia z bazą
Po migracji strony lub zmianie danych użytkownika bazy możesz musieć zaktualizować poniższe wartości:
define( 'DB_NAME', 'nazwa_bazy_danych' );
define( 'DB_USER', 'uzytkownik_bazy' );
define( 'DB_PASSWORD', 'haslo_do_bazy' );
define( 'DB_HOST', 'localhost' );
define( 'DB_CHARSET', 'utf8mb4' );Nie wpisuj przykładowych danych. Nazwę bazy, użytkownika, hasło i host pobierz z panelu hostingu. Nie zmieniaj DB_CHARSET bez wyraźnej potrzeby, ponieważ błędne ustawienie może powodować problemy z zapisem znaków.
Debugowanie i limit pamięci
Do diagnozowania błędów możesz tymczasowo włączyć logowanie, ale nie pokazuj komunikatów PHP publicznie:
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );Log błędów jest zwykle zapisywany w wp-content/debug.log. Po zakończeniu diagnozy wyłącz debugowanie i sprawdź, czy log nie jest dostępny publicznie.
Jeśli WordPress lub wtyczka zgłasza brak pamięci, możesz spróbować podnieść limit:
define( 'WP_MEMORY_LIMIT', '256M' );Ostateczny limit zależy od konfiguracji serwera. Sama zmiana w WordPressie nie podniesie limitu, którego hosting nie udostępnia.
Adres strony i zabezpieczenia panelu
Po migracji lub zmianie domeny adres można tymczasowo nadpisać w pliku:
define( 'WP_HOME', 'https://example.com' );
define( 'WP_SITEURL', 'https://example.com' );Nie dodawaj ukośnika na końcu adresu. Te stałe nadpisują wartości z bazy danych, ale nie zmieniają ich automatycznie. Przy trwałej zmianie domeny trzeba więc sprawdzić także pola home i siteurl w tabeli opcji bazy.
Przy działającym certyfikacie SSL możesz wymusić szyfrowane logowanie do panelu:
define( 'FORCE_SSL_ADMIN', true );
define( 'DISALLOW_FILE_EDIT', true );Druga stała wyłącza edytor plików motywów i wtyczek w panelu. Ogranicza to ryzyko, że osoba z przejętym kontem administratora zmieni kod bezpośrednio w WordPressie.
Prefiks tabel
Prefiks tabel określa zmienna $table_prefix:
$table_prefix = 'wp_';Zmiana prefiksu może być potrzebna, gdy kilka instalacji korzysta z jednej bazy. Nie traktuj jej jednak jako podstawowej ochrony. Nie zmieniaj tej wartości bez przygotowania odpowiadających jej nazw tabel w bazie, ponieważ WordPress straci do nich dostęp.
Co zrobić, gdy strona przestanie działać?
Jeśli po zapisie pojawi się biały ekran, błąd krytyczny albo komunikat o braku połączenia z bazą, najpierw wróć do działającej kopii pliku:
- Połącz się z serwerem przez menedżer plików, FTP, SFTP albo SSH.
- Zmień nazwę uszkodzonego pliku, zamiast od razu go usuwać.
- Wgraj kopię
wp-config.phpzapisaną przed edycją. - Sprawdź stronę i panel administracyjny w przeglądarce.
- Jeśli problem nadal występuje, sprawdź logi PHP i serwera oraz dane połączenia z bazą.
Najczęstsze przyczyny awarii to brak średnika, niezamknięty apostrof, przypadkowo usunięty nawias, zapis z nieprawidłowym kodowaniem lub błędne dane bazy. Jeśli po przywróceniu kopii strona nadal nie działa albo nie masz dostępu do serwera, przerwij kolejne próby i skontaktuj się z administratorem hostingu.
Czy trzeba edytować ten plik przy każdej zmianie w WordPressie?
Nie. Większość codziennych ustawień zmienisz w panelu administracyjnym albo w konfiguracji konkretnej wtyczki. Plik wp-config.php służy głównie do ustawień technicznych, które wymagają dostępu do serwera i powinny być zmieniane świadomie.
Najbezpieczniejsza zasada jest prosta: kopia pliku, kopia bazy, jedna zmiana naraz i kontrola działania strony po zapisie. Jeśli nie rozumiesz danej stałej lub jej wpływu na WordPressa, nie wklejaj kodu na próbę – poproś o pomoc osobę, która zna PHP i administrację serwerem.
