Během připojování k databázovému serveru došlo k chybě: co to znamená

Co hlášení říká

Při každém zobrazení stránky otevírá WordPress připojení ke své databázi MySQL nebo MariaDB se čtyřmi údaji zapsanými ve wp-config.php, v kořenovém adresáři webu:

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

„Během připojování k databázovému serveru došlo k chybě“ znamená, že toto připojení selhalo. Způsobují to čtyři příčiny: přihlašovací údaje, které už nesedí, databázový server, který je zastavený nebo nedostupný, přetížený server, nebo poškozená databáze. Následující části je procházejí od té, kterou ověříte nejsnáze, po tu nejvzácnější.

1. Odpovídá databázový server?

• Stavová stránka poskytovatele hostingu: oznamuje výpadek nebo údržbu serveru MySQL.
• Další weby na stejném účtu: pokud ve stejnou chvíli zobrazují stejnou chybu, příčina je na straně serveru a oprava u poskytovatele hostingu.
• phpMyAdmin, z panelu poskytovatele hostingu: pokud databázi otevře a zobrazí její tabulky, server běží a databáze existuje.

Pokud je příčinou server, založte u poskytovatele hostingu tiket s časem začátku výpadku a přesným zněním hlášení. Na webu mezitím nic neměňte.

2. Jsou údaje ve wp-config.php správné?

To je nejčastější příčina po stěhování webu, po změně hesla k databázi v panelu poskytovatele hostingu nebo po obnově ze zálohy. Porovnejte čtyři hodnoty ve wp-config.php se sekcí databází u svého poskytovatele hostingu:

• DB_NAME a DB_USER: mnoho poskytovatelů hostingu k nim přidává prefix s názvem účtu (ucet_wordpress). Prefix je součástí názvu.
• DB_PASSWORD: v případě pochybností nastavte uživateli v panelu nové heslo a zapište ho do souboru.
• DB_HOST: u mnoha poskytovatelů hostingu localhost, ale ne u všech. Někteří uvádějí název serveru nebo adresu, někdy s portem (:3306). Přesná hodnota je uvedena v panelu.
• Uživatel musí mít k databázi oprávnění: v panelu ověřte, že je uživatel k databázi přiřazený, se všemi oprávněními.

Heslo, které obsahuje apostrof ('), přeruší řetězec PHP, který ho ve wp-config.php obklopuje. Vložte před něj zpětné lomítko (\'), nebo zvolte heslo bez apostrofu.

Otestovat údaje mimo WordPress

WordPress zobrazí obecné hlášení. MySQL naopak přesně řekne, co je špatně. Dva způsoby, jak se ho s hodnotami z wp-config.php zeptat:

Z příkazové řádky, pokud máte přístup přes SSH

mysql -h localhost -u uzivatel -p nazev_databaze

S WP-CLI příkaz wp db check načte přímo wp-config.php a s těmito údaji zkontroluje tabulky.

Dočasným souborem PHP

Nahrajte tento soubor do kořenového adresáře webu pod názvem, který se těžko uhodne, otevřete ho v prohlížeči a pak ho hned smažte: obsahuje heslo k databázi.

<?php
mysqli_report(MYSQLI_REPORT_OFF);
$spojeni = @mysqli_connect('localhost', 'uzivatel', 'heslo', 'nazev_databaze');
echo $spojeni ? 'Připojení úspěšné' : 'Chyba: ' . mysqli_connect_error();

Na prvním řádku záleží: od PHP 8.1 vyvolá neúspěšné připojení ve výchozím nastavení výjimku a stránka by zůstala bílá, místo aby zobrazila hlášení MySQL.

3. Poškozená databáze: opravný nástroj

Když jsou údaje správné, ale některé tabulky jsou poškozené, veřejný web zobrazí stejné hlášení o chybě připojení a administrace přesnější hlášení: „Minimálně jedna databázová tabulka není dostupná. Pravděpodobně bude potřeba databázi opravit.“ WordPress k tomu poskytuje nástroj. Přidejte do wp-config.php tento řádek:

define( 'WP_ALLOW_REPAIR', true );

Pak otevřete https://www.vas-web.com/wp-admin/maint/repair.php a spusťte „Opravit databázi“. Řádek odstraňte, jakmile oprava skončí: dokud v souboru je, je tato stránka přístupná komukoli, bez přihlášení.

Před jakoukoli opravou databázi exportujte (wp db export nebo karta Export v phpMyAdminu). Pokud oprava selže, poskytovatel hostingu může databázi obnovit ze svých záloh.

4. Chyba, která přichází a odchází: zátěž

Chyba, která se objevuje v určitých hodinách a pak sama zmizí, ukazuje spíš na přetížený server než na chybné nastavení. Nejběžnější příčiny:

• Špička návštěvnosti, často roboti: opakované pokusy o přihlášení přes wp-login.php nebo xmlrpc.php, viditelné v přístupových logech poskytovatele hostingu.
• Limity sdíleného hostingu: počet souběžných připojení nebo procesů omezený na účet. Panel poskytovatele hostingu je obvykle ukazuje v sekci spotřeby zdrojů.
• Náročný plugin: statistiky, logy nebo naplánované úlohy, které při každé návštěvě zapisují do databáze.

Opravy: zablokovat zneužívající pokusy o přihlášení, nasadit cache stránek, vypnout xmlrpc.php, pokud ho žádná aplikace nepoužívá, a vyžádat si od poskytovatele hostingu logy z období, kdy se chyba objevila.