Datenbankverbindung fehlgeschlagen bei der Bildergalerie beheben

Die Meldung "Datenbankverbindung fehlgeschlagen" erscheint, wenn deine Bildergalerie keine Verbindung zur MySQL-Datenbank aufbauen kann. Ohne diese Verbindung findet das Script keine Kategorien, Titel oder Bildzuordnungen und bricht ab. Die gute Nachricht: Die Ursache liegt fast immer in den Zugangsdaten und ist mit einer geordneten Prüfung schnell gefunden.

Datenbankverbindung fehlgeschlagen bei der Bildergalerie beheben: PHP-Galerie-Icon mit Elefant, dessen Stecker nicht in die Datenbank-Zylinder-Buchse

Was passiert, wenn die Datenbankverbindung fehlgeschlagen ist

Beim Start meldet sich das Script mit vier Angaben an der Datenbank an: Servername, Benutzername, Passwort und Datenbankname. Stimmt nur einer dieser Werte nicht, weist der Datenbankserver die Anmeldung ab und die Galerie zeigt den Fehler. Diese Werte stehen in einer Konfigurationsdatei, oft config.php genannt. Genau dort beginnt jede Fehlersuche.

Datenbankverbindung fehlgeschlagen? Zugangsdaten prüfen

Vergleiche jeden Wert aus deiner Konfiguration mit den Angaben, die dir der Hoster genannt hat. Schon ein zusätzliches Leerzeichen oder ein falscher Buchstabe verhindert die Anmeldung.

Angabe	Häufiger Fehler
Servername	localhost statt eigenem Hostnamen
Benutzername	Kunden-Vorsilbe vergessen
Passwort	Sonderzeichen falsch kopiert
Datenbankname	Verwechslung mit dem Benutzernamen

Besonders der Servername sorgt für Verwirrung. Viele Anbieter nutzen nicht "localhost", sondern einen eigenen Hostnamen wie db1234.meinhoster.de. Steht in deiner Konfiguration der falsche Wert, schlägt die Verbindung trotz richtigem Passwort fehl. Auch der Benutzername bekommt bei vielen Hostern eine feste Vorsilbe vorangestellt, die leicht vergessen wird.

Datenbankverbindung fehlgeschlagen: Lösung der Reihe nach

Arbeite die Punkte nacheinander ab und teste nach jeder Änderung erneut. So weißt du genau, welcher Schritt geholfen hat.

Öffne die Konfigurationsdatei und lies die vier Werte ab.
Vergleiche sie Zeichen für Zeichen mit den Daten des Hosters.
Prüfe, ob die Datenbank im Kundenmenü überhaupt angelegt ist.
Stelle sicher, dass der Benutzer Rechte an dieser Datenbank hat.
Speichere die Datei und rufe die Galerie erneut auf.

Existiert die Datenbank noch gar nicht, musst du sie zuerst im Verwaltungsbereich deines Hosters anlegen und dem Benutzer zuweisen. Ohne diese Zuweisung kennt der Server zwar Benutzer und Datenbank, erlaubt aber keinen Zugriff. Notiere dir die neuen Werte direkt, damit sie genau in der Konfiguration landen.

Wenn die Daten stimmen

Sind alle vier Werte nachweislich korrekt und der Fehler bleibt, kann der Datenbankserver vorübergehend überlastet oder in Wartung sein. Warte einige Minuten und versuche es erneut. Tritt der Fehler nur zeitweise auf, deutet das auf eine Auslastung beim Hoster hin und nicht auf deine Einstellungen. Ein kurzer Hinweis an den Support mit der genauen Fehlermeldung und der Uhrzeit hilft bei der Klärung. Ändere deine Zugangsdaten in diesem Fall nicht, denn sie sind ja bereits richtig.

Konfigurationsdatei prüfen, wenn die Datenbankverbindung fehlgeschlagen ist

Die config.php entscheidet über den Zugang zur Datenbank, deshalb lohnt beim Bearbeiten besondere Sorgfalt. Schon eine Kleinigkeit an der falschen Stelle bringt die Verbindung zu Fall. Diese Punkte beugen den häufigsten Pannen vor.

Speichere die Datei ohne zusätzliche Leerzeichen vor oder hinter den Werten.
Setze Passwörter mit Sonderzeichen in die vorgesehenen Anführungszeichen.
Lade die Datei nach dem Speichern als reinen Text hoch, nicht im Binärmodus.

Bewahre eine Kopie der funktionierenden Konfiguration auf, bevor du Werte änderst. Stimmt nach einer Änderung etwas nicht, spielst du die alte Fassung zurück und die Galerie läuft wieder. So testest du neue Zugangsdaten gefahrlos, ohne den bisherigen Stand zu verlieren.

Wo du die richtigen Werte findest

Die vier Angaben für die Verbindung stehen nicht in der config.php, sondern im Verwaltungsbereich deines Hosters. Dort legst du Datenbanken an und siehst die zugehörigen Zugangsdaten. Genau diese Werte gehören unverändert in deine Konfiguration.

Hast du das Passwort vergessen, kannst du es im Kundenmenü meist neu setzen und danach in der config.php eintragen. Achte beim Übertragen darauf, keine Leerzeichen mitzukopieren, denn ein unsichtbares Zeichen am Ende reicht aus, damit die Anmeldung scheitert. Kopierst du die Werte direkt aus dem Kundenmenü, vermeidest du Tippfehler, die sich sonst leicht einschleichen und die Suche unnötig in die Länge ziehen.

Häufige Fragen

Bei der fehlgeschlagenen Verbindung tauchen immer wieder dieselben Fragen auf: woher die Werte kommen, was die MySQL-Meldung bedeutet und wie es nach dem Verbinden mit Umlauten weitergeht.

Woher bekomme ich die richtigen Werte für die config.php?

Die vier Angaben Servername, Benutzername, Passwort und Datenbankname stammen aus dem Verwaltungsbereich deines Hosters, nicht aus der config.php selbst. Die config.php ist nur die Ablage, du kopierst die Werte unverändert aus dem Kundenmenü dorthin, am besten ohne mitkopierte Leerzeichen.

Was bedeutet die Meldung Access denied for user oder Unknown database?

Access denied for user heißt, dass Benutzername oder Passwort nicht passen oder der Benutzer keine Rechte an der Datenbank hat. Unknown database bedeutet, dass der Datenbankname falsch ist oder die Datenbank im Kundenmenü noch nicht angelegt wurde, und Can't connect to MySQL server deutet auf einen falschen Servername wie localhost statt db1234.meinhoster.de hin.

Warum werden nach dem Verbinden die Umlaute falsch dargestellt?

Das ist ein getrenntes Zeichensatz-Problem: Die Verbindung steht zwar, aber Datenbank und Script nutzen unterschiedliche Kodierungen. Setze die Verbindung direkt nach dem Verbinden auf utf8mb4, damit Umlaute korrekt aus der Datenbank kommen.