„Error establishing a database connection“ patří mezi chyby, které dokážou WordPress web úplně vyřadit z provozu. Návštěvník místo stránky vidí pouze oznámení o problému s databázovým připojením.
WordPress ukládá většinu důležitých informací právě do databáze. Pokud se k ní nedokáže připojit, nemůže načíst obsah, nastavení ani uživatelské údaje.
Příčina může být poměrně jednoduchá, například špatný údaj v konfiguraci, ale také může jít o problém na hostingu nebo poškozenou databázi.
Proč WordPress nemůže připojit databázi?
Mezi nejčastější příčiny patří:
- špatné přihlašovací údaje k databázi,
- nedostupný databázový server,
- změněný název databáze nebo databázového uživatele,
- poškozená databáze,
- problém s hostingem,
- vyčerpané prostředky serveru,
- chyba po migraci webu.
1. Zkontrolujte soubor wp-config.php
WordPress potřebuje pro připojení k databázi správné údaje. Najdete je v hlavním konfiguračním souboru wp-config.php.
Důležité jsou především hodnoty:
- DB_NAME – název databáze,
- DB_USER – databázový uživatel,
- DB_PASSWORD – heslo k databázi,
- DB_HOST – adresa databázového serveru.
Pokud se některý z těchto údajů změnil nebo je nesprávný, WordPress se k databázi nepřipojí.
2. Ověřte stav databáze na hostingu
Přihlaste se do administrace hostingu a ověřte, zda databáze a databázový server fungují. Pokud je problém na straně hostingu, nemusí být na samotném WordPressu vůbec nic špatně.
U výpadku databázového serveru může být nejrychlejším řešením kontaktovat technickou podporu hostingu a ověřit aktuální stav služby.
3. Vznikla chyba po migraci webu?
Pokud se chyba objevila bezprostředně po migraci WordPressu na jiný hosting, je potřeba zkontrolovat především konfiguraci databáze.
Nový hosting může používat jiné údaje, jiný název databáze nebo odlišnou adresu databázového serveru.
Pokud právě řešíte převod webu z jiného systému na WordPress, může být užitečný také článek Jak přejít na WordPress, když už mám web na jiném systému?.
4. Databáze může být poškozená
V některých případech jsou databázové tabulky poškozené. WordPress pak může mít problém s jejich načítáním nebo se mohou objevovat další chyby.
Před jakýmkoli pokusem o opravu je vhodné vytvořit zálohu databáze. Pokud není jasné, co přesně je poškozené, není dobré provádět náhodné opravy přímo v databázi.
5. Může být problém v hostingu
Pokud jste na webu nic neměnili a chyba databázového připojení se objevila náhle, může být problém na serveru.
Příčinou může být například výpadek databázové služby, přetížení serveru nebo vyčerpání dostupných prostředků.
Pokud se současně web výrazně zpomalil nebo začal vykazovat další chyby, může být vhodné provést širší technickou diagnostiku.
6. Zkontrolujte dostupnost databáze
Pokud máte přístup k nástrojům hostingu, můžete ověřit, zda je databáze dostupná a zda se k ní lze přihlásit. U některých hostingů je možné databázi spravovat například prostřednictvím nástroje typu phpMyAdmin.
Pokud se do databáze nelze připojit ani přes nástroj hostingu, je pravděpodobnější problém s databází nebo serverem než se samotným WordPressem.
7. Neprovádějte změny v databázi bez zálohy
Databáze obsahuje prakticky veškerý důležitý obsah WordPressu. Neodborný zásah může způsobit ztrátu dat nebo další poškození webu.
Před opravou databáze proto vždy doporučuji vytvořit zálohu, pokud je to možné.
Pravidelné zálohování je důležité i kvůli jiným typům problémů. Více informací najdete v článku Jak zálohovat web na WordPressu?.
Co když chyba stále trvá?
Pokud jsou údaje v wp-config.php správné, databáze je dostupná a přesto WordPress chybu zobrazuje, může být potřeba prověřit další části webu a serveru.
U složitějších případů může jít například o problém s oprávněními, konfigurací serveru, poškozenou databází nebo nedostatkem systémových prostředků.
V takové situaci je důležité nejprve najít skutečnou příčinu a teprve potom provést opravu.
Kdy požádat o pomoc?
Pokud si nejste jistí prací s databází nebo chyba vyřadila důležitý firemní web z provozu, není vhodné experimentovat přímo na ostrém webu.
S diagnostikou a opravou může pomoci WordPress programátor, který může prověřit konfiguraci WordPressu, databázi i serverové prostředí.
Závěr
Chyba databázového připojení ve WordPressu znamená, že se WordPress nedokáže připojit ke své databázi. Začněte kontrolou údajů v souboru wp-config.php a ověřením dostupnosti databáze na hostingu.
Pokud problém vznikl po migraci, zaměřte se na konfiguraci nového serveru. Pokud se objevil bez předchozích změn, může být příčina na straně hostingu nebo samotné databáze.
V každém případě je před zásahy do databáze vhodné myslet na zálohu a u důležitého webu raději problém nejprve správně diagnostikovat.
Často kladené otázky
Co znamená „Error establishing a database connection“?
Znamená to, že se WordPress nedokázal připojit ke své databázi a nemůže proto načíst potřebná data webu.
Může chybu způsobit hosting?
Ano. Databázový server může být dočasně nedostupný, přetížený nebo může být problém s jeho konfigurací.
Může chybu způsobit migrace WordPressu?
Ano. Po migraci je potřeba zkontrolovat zejména údaje o databázi v souboru wp-config.php a ověřit, zda WordPress používá správnou databázi na novém serveru.
Je bezpečné opravovat databázi WordPressu ručně?
Ručně lze databázi opravovat, ale pouze s dostatečnou znalostí toho, co konkrétní změna způsobí. Před zásahem je vhodné vytvořit zálohu databáze.
