WordPress

The Most Common WordPress Installation Errors and How to Fix Them

The six most common WordPress installation errors: database, white screen, 404, permissions, already installed, HTTPS

WordPress installation usually goes smoothly, but sometimes you may run into an error screen. The good news: nearly all of these errors are well-known and fixable problems. In this article you'll find the six most common errors encountered during WordPress installation along with a step-by-step fix for each.

The Most Common Installation Errors

The six most common WordPress installation errors
The six most common errors during WordPress installation.

1) Database Connection Error (Error establishing a database connection)

This is the most common error and usually stems from incorrect database credentials in wp-config.php.

Error establishing a database connection screen
The “Error establishing a database connection” error screen.
  • Check the credentials: Make sure the DB_NAME, DB_USER, DB_PASSWORD and DB_HOST values in wp-config.php exactly match the ones you created in cPanel.
  • Verify the host: On most shared hosting localhost is correct; if your provider gives a different host, use that one.
  • Check the privileges: The user must be added to the database with ALL PRIVILEGES.
  • Reset the password: If in doubt, reset the user's password in cPanel and update wp-config.php accordingly.

2) White Screen (White Screen of Death)

If the site shows a completely blank, white screen, there is usually a PHP error. The cause is most often a plugin/theme conflict or an insufficient PHP memory limit.

  • Enable debugging: Set define('WP_DEBUG', true); in wp-config.php to see the actual error.
  • Increase the memory limit: Add define('WP_MEMORY_LIMIT', '256M'); to wp-config.php.
  • Disable plugins/theme: Temporarily rename the wp-content/plugins folder over FTP to disable all plugins.

3) 404 Errors After Installation

If the homepage opens but inner pages return “404 Not Found”, the problem is with the permalinks.

  • Log in to the WordPress dashboard, open Settings > Permalinks and click Save Changes without changing anything. This regenerates the .htaccess rules.
  • On Apache servers, make sure the .htaccess file is writable and the mod_rewrite module is enabled.

4) File Permission / FTP Upload Errors

Errors like “Unable to write to the installation directory” or upload failures usually come from incorrect file permissions.

  • Fix the permissions: Folders should be 755 and files 644. In your FTP client you can right-click a file and set its permissions.
  • Check ownership: Make sure the files belong to the correct user; if needed, ask your hosting support for help.
  • Don't use 777: Wide-open permissions create a security risk and are usually unnecessary.

5) The “WordPress Is Already Installed” Warning

If you get an “It looks like it's already installed” warning when starting the setup, there are leftover tables in the database from a previous attempt.

  • Go to cPanel > phpMyAdmin and delete the old WordPress tables from the relevant database (or start fresh with a clean, empty database).
  • Creating a new database and updating wp-config.php to match it is also a quick fix.

6) Mixed Content / HTTPS Issues

If the design breaks after switching the site to https, or you see a “not secure” warning, the page is still loading resources over http (mixed content).

  • Update the WordPress Address and Site Address with https:// under Settings > General.
  • Update the old http links in the database to https using a search-and-replace plugin.
  • Verify in cPanel that SSL is installed correctly.

A General Approach to Fixing Errors

The path to follow for WordPress installation errors
The general troubleshooting path to follow for installation errors.

Whatever the error, follow a logical order: read the error message in full, verify the wp-config.php credentials, check the permissions, see the real error with WP_DEBUG, and if it's plugin/theme related, test by disabling them.

Frequently Asked Questions (FAQ)

What most often causes the database connection error?

Almost always an incorrect database name, user, password or host in wp-config.php. Compare these four values exactly against the ones in cPanel.

Nothing shows up on the white screen — how do I find the error?

You can bring the actual PHP error to the screen by setting WP_DEBUG to true in wp-config.php; set it back to false once the problem is solved.

All inner pages return 404 — what should I do?

Opening Settings > Permalinks and clicking Save Changes is usually enough; this regenerates the .htaccess rules.

Can I prevent these errors entirely?

Most of them, yes: correct database credentials, correct file permissions, an up-to-date PHP version and taking a backup before installation prevent the bulk of these errors.

Conclusion

Nearly all WordPress installation errors are well-known and fixable problems. Verifying the database credentials, fixing file permissions, regenerating the permalinks and seeing the real error with WP_DEBUG solves the majority of cases. If you'd like to revisit the installation from the start, you can return to our WordPress installation guide.

Related Guides

Need help with your website, hosting or SEO? Get in touch with me.

WordPress

Die häufigsten WordPress-Installationsfehler und wie Sie sie beheben

Die sechs häufigsten WordPress-Installationsfehler: Datenbank, weißer Bildschirm, 404, Berechtigungen, bereits installiert, HTTPS

Die WordPress-Installation verläuft in der Regel reibungslos, doch manchmal stoßen Sie möglicherweise auf einen Fehlerbildschirm. Die gute Nachricht: Nahezu alle dieser Fehler sind bekannte und behebbare Probleme. In diesem Artikel finden Sie die sechs häufigsten Fehler, die bei der WordPress-Installation auftreten, sowie für jeden davon eine Schritt-für-Schritt-Lösung.

Die häufigsten Installationsfehler

Die sechs häufigsten WordPress-Installationsfehler
Die sechs häufigsten Fehler bei der WordPress-Installation.

1) Datenbankverbindungsfehler (Error establishing a database connection)

Dies ist der häufigste Fehler und resultiert in der Regel aus falschen Datenbank-Zugangsdaten in wp-config.php.

Bildschirm Error establishing a database connection
Der Fehlerbildschirm „Error establishing a database connection“.
  • Prüfen Sie die Zugangsdaten: Stellen Sie sicher, dass die Werte DB_NAME, DB_USER, DB_PASSWORD und DB_HOST in wp-config.php exakt mit denen übereinstimmen, die Sie in cPanel erstellt haben.
  • Überprüfen Sie den Host: Bei den meisten Shared-Hosting-Angeboten ist localhost korrekt; gibt Ihr Anbieter einen anderen Host an, verwenden Sie diesen.
  • Prüfen Sie die Berechtigungen: Der Benutzer muss mit ALL PRIVILEGES zur Datenbank hinzugefügt sein.
  • Setzen Sie das Passwort zurück: Im Zweifelsfall setzen Sie das Benutzerpasswort in cPanel zurück und aktualisieren Sie wp-config.php entsprechend.

2) Weißer Bildschirm (White Screen of Death)

Zeigt die Website einen vollständig leeren, weißen Bildschirm, liegt in der Regel ein PHP-Fehler vor. Die Ursache ist meist ein Plugin-/Theme-Konflikt oder ein unzureichendes PHP-Speicherlimit.

  • Aktivieren Sie das Debugging: Setzen Sie define('WP_DEBUG', true); in wp-config.php, um den tatsächlichen Fehler zu sehen.
  • Erhöhen Sie das Speicherlimit: Fügen Sie define('WP_MEMORY_LIMIT', '256M'); zu wp-config.php hinzu.
  • Deaktivieren Sie Plugins/Theme: Benennen Sie den Ordner wp-content/plugins per FTP vorübergehend um, um alle Plugins zu deaktivieren.

3) 404-Fehler nach der Installation

Öffnet sich die Startseite, geben Unterseiten aber „404 Not Found“ zurück, liegt das Problem bei den Permalinks.

  • Melden Sie sich im WordPress-Dashboard an, öffnen Sie Einstellungen > Permalinks und klicken Sie auf Änderungen speichern, ohne etwas zu ändern. Dadurch werden die .htaccess-Regeln neu generiert.
  • Stellen Sie auf Apache-Servern sicher, dass die Datei .htaccess beschreibbar und das Modul mod_rewrite aktiviert ist.

4) Dateiberechtigungs- / FTP-Upload-Fehler

Fehler wie „Unable to write to the installation directory“ oder fehlgeschlagene Uploads entstehen meist durch falsche Dateiberechtigungen.

  • Korrigieren Sie die Berechtigungen: Ordner sollten 755 und Dateien 644 sein. In Ihrem FTP-Client können Sie mit der rechten Maustaste auf eine Datei klicken und ihre Berechtigungen festlegen.
  • Prüfen Sie den Eigentümer: Stellen Sie sicher, dass die Dateien dem richtigen Benutzer gehören; bitten Sie bei Bedarf den Support Ihres Hosters um Hilfe.
  • Verwenden Sie nicht 777: Weit geöffnete Berechtigungen stellen ein Sicherheitsrisiko dar und sind in der Regel unnötig.

5) Die Warnung „WordPress ist bereits installiert“

Erhalten Sie beim Starten der Einrichtung eine Warnung „Es sieht so aus, als wäre es bereits installiert“, befinden sich in der Datenbank noch übrig gebliebene Tabellen aus einem früheren Versuch.

  • Gehen Sie zu cPanel > phpMyAdmin und löschen Sie die alten WordPress-Tabellen aus der betreffenden Datenbank (oder beginnen Sie mit einer sauberen, leeren Datenbank neu).
  • Eine neue Datenbank zu erstellen und wp-config.php entsprechend zu aktualisieren, ist ebenfalls eine schnelle Lösung.

6) Mixed Content / HTTPS-Probleme

Bricht das Design auseinander, nachdem Sie die Website auf https umgestellt haben, oder sehen Sie eine Warnung „nicht sicher“, lädt die Seite weiterhin Ressourcen über http (Mixed Content).

  • Aktualisieren Sie unter Einstellungen > Allgemein die WordPress-Adresse und die Website-Adresse mit https://.
  • Aktualisieren Sie die alten http-Links in der Datenbank mit einem Such-und-Ersetzen-Plugin auf https.
  • Überprüfen Sie in cPanel, dass SSL korrekt installiert ist.

Eine allgemeine Vorgehensweise zur Fehlerbehebung

Der bei WordPress-Installationsfehlern einzuschlagende Weg
Der allgemeine Weg zur Fehlerbehebung bei Installationsfehlern.

Welcher Fehler auch immer auftritt, gehen Sie in einer logischen Reihenfolge vor: Lesen Sie die Fehlermeldung vollständig, überprüfen Sie die Zugangsdaten in wp-config.php, prüfen Sie die Berechtigungen, sehen Sie den tatsächlichen Fehler mit WP_DEBUG und testen Sie bei Plugin-/Theme-Bezug durch deren Deaktivierung.

Häufig gestellte Fragen (FAQ)

Wodurch wird der Datenbankverbindungsfehler am häufigsten verursacht?

Fast immer durch einen falschen Datenbanknamen, Benutzer, ein falsches Passwort oder einen falschen Host in wp-config.php. Vergleichen Sie diese vier Werte exakt mit denen in cPanel.

Auf dem weißen Bildschirm ist nichts zu sehen – wie finde ich den Fehler?

Sie können den tatsächlichen PHP-Fehler auf den Bildschirm bringen, indem Sie WP_DEBUG in wp-config.php auf true setzen; setzen Sie es nach Behebung des Problems wieder auf false.

Alle Unterseiten geben 404 zurück – was soll ich tun?

Einstellungen > Permalinks zu öffnen und auf Änderungen speichern zu klicken, reicht in der Regel aus; dadurch werden die .htaccess-Regeln neu generiert.

Kann ich diese Fehler vollständig vermeiden?

Die meisten davon, ja: korrekte Datenbank-Zugangsdaten, korrekte Dateiberechtigungen, eine aktuelle PHP-Version und ein Backup vor der Installation verhindern den Großteil dieser Fehler.

Fazit

Nahezu alle WordPress-Installationsfehler sind bekannte und behebbare Probleme. Das Überprüfen der Datenbank-Zugangsdaten, das Korrigieren der Dateiberechtigungen, das Neugenerieren der Permalinks und das Sichtbarmachen des tatsächlichen Fehlers mit WP_DEBUG löst die Mehrzahl der Fälle. Wenn Sie die Installation von Anfang an noch einmal durchgehen möchten, können Sie zu unserem WordPress-Installationsleitfaden zurückkehren.

Verwandte Leitfäden

Benötigen Sie Hilfe bei Ihrer Website, beim Hosting oder bei SEO? Nehmen Sie Kontakt mit mir auf.

WordPress

Les erreurs d'installation WordPress les plus courantes et comment les résoudre

Les six erreurs d'installation WordPress les plus courantes : base de données, écran blanc, 404, permissions, déjà installé, HTTPS

L'installation de WordPress se déroule généralement sans problème, mais il peut arriver que vous tombiez sur un écran d'erreur. La bonne nouvelle : la quasi-totalité de ces erreurs sont des problèmes connus et résolvables. Dans cet article, vous trouverez les six erreurs les plus fréquemment rencontrées lors de l'installation de WordPress, accompagnées d'une solution étape par étape pour chacune.

Les erreurs d'installation les plus courantes

Les six erreurs d'installation WordPress les plus courantes
Les six erreurs les plus courantes lors de l'installation de WordPress.

1) Erreur de connexion à la base de données (Error establishing a database connection)

C'est l'erreur la plus courante et elle provient généralement d'identifiants de base de données incorrects dans wp-config.php.

Écran Error establishing a database connection
L'écran d'erreur « Error establishing a database connection ».
  • Vérifiez les identifiants : Assurez-vous que les valeurs DB_NAME, DB_USER, DB_PASSWORD et DB_HOST dans wp-config.php correspondent exactement à celles que vous avez créées dans cPanel.
  • Vérifiez l'hôte : Sur la plupart des hébergements mutualisés, localhost est correct ; si votre hébergeur fournit un autre hôte, utilisez celui-ci.
  • Vérifiez les privilèges : L'utilisateur doit être ajouté à la base de données avec ALL PRIVILEGES.
  • Réinitialisez le mot de passe : En cas de doute, réinitialisez le mot de passe de l'utilisateur dans cPanel et mettez wp-config.php à jour en conséquence.

2) Écran blanc (White Screen of Death)

Si le site affiche un écran entièrement vide et blanc, il y a généralement une erreur PHP. La cause est le plus souvent un conflit de plugin/thème ou une limite de mémoire PHP insuffisante.

  • Activez le débogage : Définissez define('WP_DEBUG', true); dans wp-config.php pour voir l'erreur réelle.
  • Augmentez la limite de mémoire : Ajoutez define('WP_MEMORY_LIMIT', '256M'); à wp-config.php.
  • Désactivez les plugins/le thème : Renommez temporairement le dossier wp-content/plugins via FTP pour désactiver tous les plugins.

3) Erreurs 404 après l'installation

Si la page d'accueil s'ouvre mais que les pages internes renvoient « 404 Not Found », le problème vient des permaliens.

  • Connectez-vous au tableau de bord WordPress, ouvrez Réglages > Permaliens et cliquez sur Enregistrer les modifications sans rien changer. Cela régénère les règles .htaccess.
  • Sur les serveurs Apache, assurez-vous que le fichier .htaccess est accessible en écriture et que le module mod_rewrite est activé.

4) Erreurs de permissions de fichiers / d'envoi FTP

Les erreurs telles que « Unable to write to the installation directory » ou les échecs d'envoi proviennent généralement de permissions de fichiers incorrectes.

  • Corrigez les permissions : Les dossiers doivent être en 755 et les fichiers en 644. Dans votre client FTP, vous pouvez faire un clic droit sur un fichier et définir ses permissions.
  • Vérifiez la propriété : Assurez-vous que les fichiers appartiennent au bon utilisateur ; au besoin, demandez de l'aide au support de votre hébergeur.
  • N'utilisez pas 777 : Des permissions trop ouvertes constituent un risque de sécurité et sont généralement inutiles.

5) L'avertissement « WordPress est déjà installé »

Si vous recevez un avertissement « Il semble que ce soit déjà installé » au démarrage de l'installation, c'est qu'il reste dans la base de données des tables d'une tentative précédente.

  • Allez dans cPanel > phpMyAdmin et supprimez les anciennes tables WordPress de la base de données concernée (ou recommencez avec une base de données propre et vide).
  • Créer une nouvelle base de données et mettre wp-config.php à jour en conséquence est également une solution rapide.

6) Contenu mixte (Mixed Content) / Problèmes HTTPS

Si le design se casse après le passage du site en https, ou si vous voyez un avertissement « non sécurisé », c'est que la page charge encore des ressources via http (contenu mixte).

  • Mettez à jour l'adresse de WordPress et l'adresse du site avec https:// sous Réglages > Général.
  • Mettez à jour les anciens liens http de la base de données en https à l'aide d'un plugin de recherche-remplacement.
  • Vérifiez dans cPanel que le SSL est correctement installé.

Une approche générale de la résolution des erreurs

La démarche à suivre face aux erreurs d'installation de WordPress
La démarche générale de dépannage à suivre face aux erreurs d'installation.

Quelle que soit l'erreur, suivez un ordre logique : lisez le message d'erreur en entier, vérifiez les identifiants de wp-config.php, contrôlez les permissions, voyez l'erreur réelle avec WP_DEBUG et, si elle est liée à un plugin/thème, testez en les désactivant.

Foire aux questions (FAQ)

Quelle est la cause la plus fréquente de l'erreur de connexion à la base de données ?

Presque toujours un nom de base de données, un utilisateur, un mot de passe ou un hôte incorrect dans wp-config.php. Comparez ces quatre valeurs exactement avec celles de cPanel.

Rien ne s'affiche sur l'écran blanc — comment trouver l'erreur ?

Vous pouvez faire apparaître l'erreur PHP réelle à l'écran en définissant WP_DEBUG sur true dans wp-config.php ; remettez-le sur false une fois le problème résolu.

Toutes les pages internes renvoient une 404 — que dois-je faire ?

Ouvrir Réglages > Permaliens et cliquer sur Enregistrer les modifications suffit généralement ; cela régénère les règles .htaccess.

Puis-je éviter complètement ces erreurs ?

La plupart d'entre elles, oui : des identifiants de base de données corrects, des permissions de fichiers correctes, une version PHP à jour et une sauvegarde avant l'installation préviennent la majeure partie de ces erreurs.

Conclusion

La quasi-totalité des erreurs d'installation de WordPress sont des problèmes connus et résolvables. Vérifier les identifiants de la base de données, corriger les permissions de fichiers, régénérer les permaliens et voir l'erreur réelle avec WP_DEBUG résout la majorité des cas. Si vous souhaitez reprendre l'installation depuis le début, vous pouvez revenir à notre guide d'installation de WordPress.

Guides connexes

Besoin d'aide pour votre site web, votre hébergement ou votre SEO ? Contactez-moi.

WordPress

Gli errori di installazione di WordPress più comuni e come risolverli

I sei errori di installazione di WordPress più comuni: database, schermata bianca, 404, permessi, già installato, HTTPS

L'installazione di WordPress di solito procede senza intoppi, ma a volte può capitare di imbattersi in una schermata di errore. La buona notizia: quasi tutti questi errori sono problemi noti e risolvibili. In questo articolo troverà i sei errori più comuni riscontrati durante l'installazione di WordPress, ciascuno accompagnato da una soluzione passo passo.

Gli errori di installazione più comuni

I sei errori di installazione di WordPress più comuni
I sei errori più comuni durante l'installazione di WordPress.

1) Errore di connessione al database (Error establishing a database connection)

È l'errore più comune e di solito deriva da credenziali del database errate in wp-config.php.

Schermata Error establishing a database connection
La schermata di errore «Error establishing a database connection».
  • Controlli le credenziali: Si assicuri che i valori DB_NAME, DB_USER, DB_PASSWORD e DB_HOST in wp-config.php corrispondano esattamente a quelli creati in cPanel.
  • Verifichi l'host: Sulla maggior parte degli hosting condivisi localhost è corretto; se il suo provider indica un host diverso, utilizzi quello.
  • Controlli i privilegi: L'utente deve essere aggiunto al database con ALL PRIVILEGES.
  • Reimposti la password: In caso di dubbio, reimposti la password dell'utente in cPanel e aggiorni di conseguenza wp-config.php.

2) Schermata bianca (White Screen of Death)

Se il sito mostra una schermata completamente vuota e bianca, è in genere presente un errore PHP. La causa è il più delle volte un conflitto di plugin/tema o un limite di memoria PHP insufficiente.

  • Attivi il debug: Imposti define('WP_DEBUG', true); in wp-config.php per vedere l'errore reale.
  • Aumenti il limite di memoria: Aggiunga define('WP_MEMORY_LIMIT', '256M'); a wp-config.php.
  • Disattivi plugin/tema: Rinomini temporaneamente la cartella wp-content/plugins tramite FTP per disattivare tutti i plugin.

3) Errori 404 dopo l'installazione

Se la home page si apre ma le pagine interne restituiscono «404 Not Found», il problema riguarda i permalink.

  • Acceda alla bacheca di WordPress, apra Impostazioni > Permalink e faccia clic su Salva modifiche senza modificare nulla. In questo modo vengono rigenerate le regole .htaccess.
  • Sui server Apache, si assicuri che il file .htaccess sia scrivibile e che il modulo mod_rewrite sia abilitato.

4) Errori di permessi dei file / di caricamento FTP

Errori come «Unable to write to the installation directory» o caricamenti non riusciti derivano di solito da permessi dei file errati.

  • Corregga i permessi: Le cartelle dovrebbero essere 755 e i file 644. Nel suo client FTP può fare clic con il tasto destro su un file e impostarne i permessi.
  • Verifichi la proprietà: Si assicuri che i file appartengano all'utente corretto; se necessario, chieda aiuto al supporto del suo hosting.
  • Non usi 777: Permessi troppo aperti costituiscono un rischio per la sicurezza e di solito non sono necessari.

5) L'avviso «WordPress è già installato»

Se all'avvio dell'installazione riceve l'avviso «Sembra che sia già installato», significa che nel database sono rimaste tabelle di un tentativo precedente.

  • Vada in cPanel > phpMyAdmin ed elimini le vecchie tabelle di WordPress dal database in questione (oppure ricominci da capo con un database pulito e vuoto).
  • Anche creare un nuovo database e aggiornare di conseguenza wp-config.php è una soluzione rapida.

6) Contenuto misto (Mixed Content) / Problemi HTTPS

Se il design si rompe dopo aver passato il sito a https, oppure vede un avviso «non sicuro», significa che la pagina sta ancora caricando risorse tramite http (contenuto misto).

  • Aggiorni l'Indirizzo WordPress e l'Indirizzo del sito con https:// in Impostazioni > Generali.
  • Aggiorni i vecchi link http nel database in https utilizzando un plugin di ricerca e sostituzione.
  • Verifichi in cPanel che l'SSL sia installato correttamente.

Un approccio generale alla risoluzione degli errori

Il percorso da seguire per gli errori di installazione di WordPress
Il percorso generale di risoluzione dei problemi da seguire per gli errori di installazione.

Qualunque sia l'errore, segua un ordine logico: legga per intero il messaggio di errore, verifichi le credenziali in wp-config.php, controlli i permessi, veda l'errore reale con WP_DEBUG e, se è legato a un plugin/tema, faccia una prova disattivandoli.

Domande frequenti (FAQ)

Qual è la causa più frequente dell'errore di connessione al database?

Quasi sempre un nome database, un utente, una password o un host errato in wp-config.php. Confronti questi quattro valori esattamente con quelli presenti in cPanel.

Sulla schermata bianca non si vede nulla: come trovo l'errore?

Può portare l'errore PHP reale sullo schermo impostando WP_DEBUG su true in wp-config.php; una volta risolto il problema, lo riporti su false.

Tutte le pagine interne restituiscono 404: cosa devo fare?

Aprire Impostazioni > Permalink e fare clic su Salva modifiche è di solito sufficiente; in questo modo vengono rigenerate le regole .htaccess.

Posso evitare completamente questi errori?

La maggior parte sì: credenziali del database corrette, permessi dei file corretti, una versione PHP aggiornata e un backup prima dell'installazione prevengono la maggior parte di questi errori.

Conclusione

Quasi tutti gli errori di installazione di WordPress sono problemi noti e risolvibili. Verificare le credenziali del database, correggere i permessi dei file, rigenerare i permalink e rendere visibile l'errore reale con WP_DEBUG risolve la maggior parte dei casi. Se desidera ripercorrere l'installazione dall'inizio, può tornare alla nostra guida all'installazione di WordPress.

Guide correlate

Ha bisogno di aiuto con il suo sito web, l'hosting o la SEO? Mi contatti.

WordPress

WordPress Kurulumunda En Yaygın Hatalar ve Çözümleri

WordPress kurulumunda en sık 6 hata: veritabanı, beyaz ekran, 404, izinler, zaten kurulu, HTTPS

WordPress kurulumu genelde sorunsuz geçer, ama bazen bir hata ekranıyla karşılaşabilirsiniz. İyi haber: bu hataların neredeyse tamamı bilinen ve çözülebilir sorunlardır. Bu yazıda WordPress kurulumu sırasında en sık karşılaşılan altı hatayı ve her birinin adım adım çözümünü bulacaksınız.

En Sık Karşılaşılan Kurulum Hataları

WordPress kurulumunda en sık altı hata
WordPress kurulumunda en sık görülen altı hata.

1) Veritabanı Bağlantı Hatası (Error establishing a database connection)

En sık görülen hatadır ve genellikle wp-config.php içindeki veritabanı bilgilerinin yanlış olmasından kaynaklanır.

Error establishing a database connection ekranı
“Error establishing a database connection” hata ekranı.
  • Bilgileri kontrol edin: wp-config.php'deki DB_NAME, DB_USER, DB_PASSWORD ve DB_HOST değerlerinin cPanel'de oluşturduğunuzla birebir aynı olduğundan emin olun.
  • Host'u doğrulayın: Çoğu paylaşımlı hostingde localhost doğrudur; sağlayıcınız farklı bir host veriyorsa onu kullanın.
  • Yetkileri kontrol edin: Kullanıcının veritabanına ALL PRIVILEGES ile eklenmiş olması gerekir.
  • Şifreyi sıfırlayın: Şüphedeyseniz cPanel'den kullanıcı şifresini yenileyip wp-config.php'yi güncelleyin.

2) Beyaz Ekran (White Screen of Death)

Site tamamen boş, beyaz bir ekran gösteriyorsa genellikle bir PHP hatası vardır. Nedeni çoğunlukla eklenti/tema çakışması ya da yetersiz PHP bellek limitidir.

  • Hata ayıklamayı açın: wp-config.php'de define('WP_DEBUG', true); yaparak gerçek hatayı görün.
  • Bellek limitini artırın: wp-config.php'ye define('WP_MEMORY_LIMIT', '256M'); ekleyin.
  • Eklenti/temayı devre dışı bırakın: FTP ile wp-content/plugins klasörünü geçici yeniden adlandırarak tüm eklentileri kapatın.

3) Kurulumdan Sonra 404 Hataları

Ana sayfa açılıyor ama iç sayfalar “404 Not Found” veriyorsa, sorun kalıcı bağlantılardadır (permalink).

  • WordPress paneline girip Ayarlar > Kalıcı Bağlantılar sayfasını açın ve hiçbir şey değiştirmeden Değişiklikleri Kaydet'e tıklayın. Bu, .htaccess kurallarını yeniler.
  • Apache sunucularda .htaccess dosyasının yazılabilir olduğundan ve mod_rewrite modülünün etkin olduğundan emin olun.

4) Dosya İzni / FTP Yükleme Hataları

“Kurulum dizinine yazılamıyor” veya yükleme hatalarının kaynağı genellikle yanlış dosya izinleridir.

  • İzinleri düzeltin: Klasörler 755, dosyalar 644 olmalı. FTP istemcisinde dosyaya sağ tıklayıp izinleri ayarlayabilirsiniz.
  • Sahipliği kontrol edin: Dosyaların doğru kullanıcıya ait olduğundan emin olun; gerekirse hosting desteğinden yardım isteyin.
  • 777 vermeyin: Geniş izinler güvenlik riski oluşturur ve genelde gereksizdir.

5) “WordPress Zaten Kurulu” Uyarısı

Kuruluma başladığınızda “Zaten kurulu görünüyor” uyarısı alıyorsanız, veritabanında önceki bir denemeden kalma tablolar var demektir.

  • cPanel > phpMyAdmin'e girip ilgili veritabanındaki eski WordPress tablolarını silin (veya temiz, boş bir veritabanıyla yeniden başlayın).
  • Yeni bir veritabanı oluşturup wp-config.php'yi ona göre güncellemek de hızlı bir çözümdür.

6) Karışık İçerik / HTTPS Sorunları

Site https'e geçtikten sonra tasarım bozuksa veya “güvenli değil” uyarısı çıkıyorsa, sayfa hâlâ http üzerinden kaynak yüklüyordur (karışık içerik).

  • Ayarlar > Genel'den WordPress Adresi ve Site Adresi'ni https:// ile güncelleyin.
  • Veritabanındaki eski http bağlantılarını bir arama-değiştirme eklentisiyle https olarak güncelleyin.
  • cPanel'den SSL'in doğru kurulduğunu doğrulayın.

Hata Çözümünde Genel Yaklaşım

WordPress kurulum hatalarında izlenecek yol
Kurulum hatalarında izlenecek genel sorun giderme yolu.

Hangi hata olursa olsun, mantıklı bir sıra izleyin: hata mesajını tam okuyun, wp-config.php bilgilerini doğrulayın, izinleri kontrol edin, WP_DEBUG ile gerçek hatayı görün ve eklenti/tema kaynaklıysa devre dışı bırakarak test edin.

Sıkça Sorulan Sorular (SSS)

Veritabanı bağlantı hatası en çok neden olur?

Neredeyse her zaman wp-config.php'deki veritabanı adı, kullanıcı, şifre veya host bilgilerinin yanlış olmasından. Bu dört değeri cPanel'deki değerlerle birebir karşılaştırın.

Beyaz ekranda hiçbir şey görünmüyor, hatayı nasıl bulurum?

wp-config.php'de WP_DEBUG'ı true yaparak gerçek PHP hatasını ekrana getirebilirsiniz; sorunu çözünce tekrar false yapın.

Tüm iç sayfalar 404 veriyor, ne yapmalıyım?

Ayarlar > Kalıcı Bağlantılar sayfasını açıp Değişiklikleri Kaydet'e tıklamak çoğu zaman yeterlidir; bu .htaccess kurallarını yeniler.

Bu hataları tamamen önleyebilir miyim?

Çoğunu evet: doğru veritabanı bilgileri, doğru dosya izinleri, güncel PHP sürümü ve kurulumdan önce yedek almak hataların büyük kısmını önler.

Sonuç

WordPress kurulum hatalarının neredeyse tamamı bilinen ve çözülebilir sorunlardır. Veritabanı bilgilerini doğrulamak, dosya izinlerini düzeltmek, kalıcı bağlantıları yenilemek ve WP_DEBUG ile gerçek hatayı görmek vakaların büyük kısmını çözer. Kuruluma baştan bakmak isterseniz WordPress kurulumu rehberimize dönebilirsiniz.

İlgili Rehberler

Web siteniz, hosting veya SEO ile ilgili desteğe mi ihtiyacınız var? Benimle iletişime geçin.