Chyba při navazování připojení k databázi (Error establishing a database connection)

Místo webu se zobrazí jediná věta: „Chyba při navazování připojení k databázi“, anglicky „Error establishing a database connection“. WordPress se dostal k souborům, ale ne k datům. Vypadá to hrozivě, obsah ale obvykle nikam nezmizel, web se k němu jen nedostane. Příčiny jsou tři a vyplatí se je zkoušet v tomto pořadí.

Možné příčiny

• Databázový server je dočasně nedostupný nebo přetížený. Web se po chvíli rozběhne sám.
• Web má špatné přihlašovací údaje. Typicky po přestěhování webu, po změně hesla k databázi nebo po obnově zálohy z jiného serveru.
• Databáze je poškozená. Některé tabulky jsou rozbité po nedokončené aktualizaci nebo výpadku. Poznáte to tak, že administrace hlásí jinou chybu než veřejná část, nebo chybí jen část obsahu.

Postup řešení

1. Počkejte pět minut a stránku obnovte. Pokud web naskočí sám, šlo o krátkodobý výpadek nebo přetížení databázového serveru. Když se to opakuje, poznamenejte si čas a napište podpoře.
2. Přihlaste se do phpMyAdmin z klientské sekce u vaší domény. Pokud se nepřipojí ani phpMyAdmin, je problém na straně serveru a řeší ho podpora. Pokud se připojí a vidíte tabulky, pokračujte dalším krokem.
3. Připojte se přes FTP a ve složce web otevřete soubor wp-config.php. Najděte řádky:

   define( 'DB_NAME', 'nazev_databaze' );
   define( 'DB_USER', 'uzivatel' );
   define( 'DB_PASSWORD', 'heslo' );
   define( 'DB_HOST', 'localhost' );

   Porovnejte je s údaji, které najdete v klientské sekci u domény v sekci Databáze (viz Kde najdu přihlašovací údaje k databázi). Do DB_HOST zadejte server přesně tak, jak ho uvádí klientská sekce, ne automaticky localhost.
4. Zkontrolujte časté překlepy: mezera na konci hesla, staré heslo po jeho změně, název databáze bez předpony nebo s předponou navíc. Soubor uložte a web obnovte.
5. Pokud údaje sedí a chyba trvá, spusťte vestavěnou opravu WordPressu. Do wp-config.php nad řádek /* That's all, stop editing! */ přidejte:

   define( 'WP_ALLOW_REPAIR', true );

   Otevřete adresu https://vasedomena.cz/wp-admin/maint/repair.php a zvolte „Opravit databázi“.
6. Po dokončení opravy řádek s WP_ALLOW_REPAIR z wp-config.php zase smažte. Stránka opravy je jinak dostupná komukoli bez přihlášení.
7. Pokud oprava nepomůže, požádejte podporu o obnovu databáze ze zálohy. Datahost zálohuje denně, přijdete jen o obsah přidaný po datu zálohy.

Co zkontrolovat, když nic nepomohlo

• Vyčerpaný diskový prostor. Databáze nemůže zapisovat a web hlásí chybu připojení. Prostor obvykle zaplní logy, zálohy uložené přímo na webhostingu nebo tisíce náhledů obrázků. Obsazené místo vám sdělí podpora.
• Vyčerpaný počet spojení. Doplněk nebo robot zabral všechna dostupná spojení do databáze. V error logu bývá hláška „Too many connections“.
• Napadení. Útočník někdy přepíše wp-config.php nebo změní přístupové údaje. Pokud jsou v souboru změny, které jste nedělali, postupujte podle návodu Co dělat, když byl WordPress napaden.

Kdy kontaktovat podporu

Napište na podpora@datahost.cz, když se nepřipojí ani phpMyAdmin, když údaje ve wp-config.php sedí a chyba přesto trvá, když potřebujete obnovit databázi ze zálohy, nebo když se výpadky opakují.

Do zprávy uveďte:

• doménu a název databáze (nikdy neposílejte heslo v e-mailu),
• čas, kdy se chyba objevila, a zda se opakuje,
• co jste před tím měnili (stěhování, změna hesla, obnova zálohy, aktualizace),
• zda se vám daří přihlásit do phpMyAdmin,
• datum, ke kterému chcete databázi obnovit, pokud žádáte o obnovu.