Plik wp-config.php to centralny punkt konfiguracji WordPressa. Znajduje się zwykle w głównym katalogu instalacji i przechowuje między innymi dane połączenia z bazą, ustawienia debugowania oraz klucze bezpieczeństwa. Każdą zmianę wykonuj po przygotowaniu kopii zapasowej, w edytorze zapisującym plik jako UTF-8 bez BOM i z zachowaniem składni PHP.
Czym jest plik wp-config.php i gdzie go znaleźć?
wp-config.php jest jednym z najważniejszych plików instalacji WordPressa. System odczytuje z niego parametry potrzebne do połączenia z bazą MySQL lub MariaDB, a także wybrane ustawienia działania witryny. Błędna zmiana może uniemożliwić uruchomienie strony albo panelu administracyjnego.
Pliku szukaj w katalogu, w którym znajdują się między innymi foldery wp-admin, wp-content i wp-includes. Na wielu serwerach będzie to katalog podobny do public_html. WordPress może jednak przechowywać konfigurację poziom wyżej niż główny katalog instalacji.
Nie myl go z plikiem wp-config-sample.php. Drugi z nich jest tylko szablonem dostarczanym z plikami WordPressa. Podczas instalacji system tworzy właściwy wp-config.php, a w razie potrzeby można utworzyć go ręcznie na podstawie szablonu.
Jak bezpiecznie edytować wp-config.php?
Przed każdą zmianą pobierz oryginalny plik i zachowaj go poza publicznym katalogiem serwera. Kopia pozwoli szybko przywrócić działanie witryny, jeśli po zapisaniu pojawi się błąd składni, biały ekran lub problem z połączeniem z bazą.
- Pobierz plik przez FTP, sFTP albo Menedżer plików dostępny w panelu hostingu. Upewnij się, że otwierasz konfigurację właściwej instalacji.
- Utwórz kopię pliku pod prywatną nazwą na komputerze. Nie zapisuj jej później na serwerze jako
wp-config.php.bak,wp-config.txtani podobny plik. - Otwórz kopię w edytorze tekstu przeznaczonym do kodu, na przykład Notepad++ lub Visual Studio Code. Nie używaj Worda ani zwykłego Notatnika Windows, ponieważ mogą zmienić formatowanie lub dodać BOM.
- Wprowadź tylko zaplanowaną zmianę. Zachowaj kodowanie UTF-8 bez BOM, istniejące apostrofy i układ poleceń.
- Wgraj plik na serwer i potwierdź nadpisanie oryginału. Następnie sprawdź stronę, panel administracyjny oraz funkcje, których dotyczyła zmiana.
- Jeżeli pojawi się błąd, przywróć poprzednią kopię. Gdy nie możesz tego zrobić albo występuje błąd PHP, skontaktuj się z administratorem serwera.
Składnia PHP jest bezwzględna. Każda instrukcja define() musi mieć średnik na końcu, a wartości tekstowe muszą znajdować się między apostrofami lub cudzysłowami. Brak średnika, przypadkowe usunięcie nawiasu albo nieprawidłowe kodowanie może zatrzymać wykonywanie całego pliku.
Przed zapisaniem przejdź przez krótką kontrolę:
- Każda zmieniona linia
define()kończy się średnikiem. - Apostrofy, nawiasy i przecinki występują parami.
- W nazwach stałych nie ma przypadkowych spacji ani literówek.
- Plik pozostaje zapisany jako UTF-8 bez BOM.
- W konfiguracji nie ma rzeczywistych haseł wklejonych do kopii przechowywanej publicznie.
Jak skonfigurować połączenie z bazą danych?
WordPress korzysta z danych zapisanych w kilku stałych, aby połączyć się z bazą MySQL lub MariaDB. Znajdziesz je zwykle w sekcji opisanej jako MySQL settings lub Database settings.
| Parametr | Opis | Przykładowa wartość |
|---|---|---|
DB_NAME |
Nazwa bazy używanej przez instalację WordPressa | nazwa_bazy |
DB_USER |
Użytkownik mający uprawnienia do tej bazy | uzytkownik_bazy |
DB_PASSWORD |
Hasło użytkownika bazy danych | haslo_bazy |
DB_HOST |
Adres serwera bazy, czasem z portem | localhost |
DB_CHARSET |
Zestaw znaków używany przez bazę | utf8mb4 |
Przykładowy fragment może wyglądać tak:
define( 'DB_NAME', 'nazwa_bazy' );
define( 'DB_USER', 'uzytkownik_bazy' );
define( 'DB_PASSWORD', 'haslo_bazy' );
define( 'DB_HOST', 'localhost' );
define( 'DB_CHARSET', 'utf8mb4' );Dane znajdziesz zwykle w panelu hostingu, na przykład w DirectAdmin, albo w dokumentacji utworzonej bazy. Przy migracji sprawdź pełną nazwę bazy i użytkownika, ponieważ hosting może dodawać do nich prefiks konta.
Nie zmieniaj samego DB_PASSWORD, jeśli hasło użytkownika bazy nie zostało zmienione po stronie serwera. Wpis w pliku nie ustawia nowego hasła, lecz tylko informuje WordPressa, jakiego hasła ma użyć. Jeśli dane są niepoprawne, strona może wyświetlić błąd połączenia z bazą.
Zmiennej $table_prefix nie należy mylić z nazwą bazy. Określa ona prefiks tabel, na przykład:
$table_prefix = 'wp_';Debugowanie i klucze bezpieczeństwa
Tryb debugowania
Stała WP_DEBUG służy do diagnostyki błędów WordPressa i PHP. Na czas szukania problemu możesz włączyć ją tak:
define( 'WP_DEBUG', true );Na działającej stronie nie wyświetlaj komunikatów odwiedzającym. Bezpieczniejsza konfiguracja zapisuje je do pliku wp-content/debug.log i ukrywa na stronie:
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );Po zakończeniu diagnostyki wyłącz debugowanie albo usuń wpisy, jeśli nie są już potrzebne. Publiczne komunikaty błędów mogą ujawnić ścieżki plików, nazwy funkcji i inne informacje techniczne.
Klucze uwierzytelniania i salta
Stałe takie jak AUTH_KEY, SECURE_AUTH_KEY, LOGGED_IN_KEY, NONCE_KEY oraz odpowiadające im wartości _SALT wzmacniają ochronę sesji i ciasteczek. Nie wpisuj własnych prostych haseł. Wygeneruj nowy zestaw za pomocą oficjalnego generatora kluczy WordPress i zastąp nim istniejące wartości.
Zmiana kluczy unieważnia bieżące ciasteczka sesyjne, dlatego wszyscy użytkownicy zostaną wylogowani. Taki krok ma sens między innymi po podejrzeniu przejęcia danych logowania lub infekcji witryny.
Popularne stałe konfiguracyjne
| Flaga | Funkcja | Wartość domyślna |
|---|---|---|
WP_DEBUG |
Włącza diagnostykę błędów WordPressa | false |
WP_DEBUG_LOG |
Zapisuje komunikaty debugowania do logu | false |
DISALLOW_FILE_EDIT |
Wyłącza edytor plików motywów i wtyczek w panelu | brak stałej |
WP_HOME |
Ustala adres witryny | wartość z bazy |
WP_SITEURL |
Ustala adres instalacji WordPressa | wartość z bazy |
Przy zmianie domeny można tymczasowo zdefiniować adresy w pliku:
define( 'WP_HOME', 'https://twoja-domena.pl' );
define( 'WP_SITEURL', 'https://twoja-domena.pl' );Adres powinien odpowiadać rzeczywistej konfiguracji i nie powinien kończyć się ukośnikiem. Przed zmianą wykonaj kopię pliku, ponieważ nieprawidłowy adres może zablokować stronę i panel.
Jak chronić plik wp-config.php?
Plik zawiera hasło do bazy, więc jego ujawnienie może zagrozić całej instalacji. Zakres ochrony zależy od konfiguracji serwera, ale podstawowe zasady są następujące:
- Ustaw ograniczone uprawnienia, na przykład 400 lub 440, jeśli hosting i sposób uruchamiania PHP na to pozwalają.
- Rozważ przeniesienie pliku poziom wyżej niż publiczny katalog instalacji, o ile konfiguracja serwera poprawnie obsługuje taką lokalizację.
- Nie udostępniaj pliku osobom trzecim, nie publikuj jego treści i nie pokazuj prawdziwych haseł na zrzutach ekranu.
- Usuń z serwera kopie z rozszerzeniami
.bak,.old,.txti podobnymi, ponieważ mogą zostać pobrane przez przeglądarkę.
Jeśli po edycji pojawi się błąd składni, przywróć kopię sprzed zmiany. Gdy strona nadal nie działa, sprawdź log serwera PHP lub poproś administratora hostingu o pomoc. W przypadku pliku wp-config.php ostrożność jest ważniejsza niż szybkie dodawanie kolejnych ustawień.
