WordPress Veritabanı Bağlantısı Nasıl Düzeltilir

Son doğrulama: Eylül 2026 · cPanel 136 test hesabında denendi

WordPress veritabanı bağlantısı hatası hangi yapılandırma sorunlarından çıkar?

WordPress her sayfa isteğinde wp-config.php dosyasındaki dört sabiti okuyup MySQL sunucusuna bağlanır: veritabanı adı, kullanıcı adı, şifre ve sunucu adresi. Bu dördünden biri yanlışsa WordPress veritabanına hiç ulaşamaz ve tüm site çöker. Yapılandırma hatasının en sık dört kökü vardır: site başka bir sunucuya taşınırken eski DB_HOST ya da kullanıcı bilgisinin dosyada kalması, cPanel’den şifre değiştirilip wp-config.php‘nin güncellenmemesi, kullanıcının veritabanına eklenmiş olsa bile ayrıcalık verilmemiş olması ve taşıma sırasında tablo önekinin ($table_prefix) veritabanındaki gerçek önekle uyuşmaması.

Bu, ekranda gördüğünüz hata mesajından bağımsız bir konudur: aynı “Error Establishing a Database Connection” ekranı hem yanlış yapılandırmadan hem de sunucunun o an geçici olarak yoğun olmasından çıkabilir. Siz zaten hata ekranını görüp buraya geldiyseniz ve yapılandırmanın doğru olduğundan eminseniz hata metni odaklı çözüm kartına geçebilirsiniz; bu kart baştan doğru kurulum ve güncel tutma içindir.

Bağlantı bilgilerini doğru yapılandırma — adım adım

Yöntem 1 — wp-config.php içindeki dört değeri MySQL Veritabanları ekranıyla karşılaştırma

1. cPanel → Veritabanları → MySQL® Veritabanları sayfasını açıp bu siteye ait veritabanı adını ve kullanıcı adını not edin.
   

   

   Beklenen sonuç: sayfada veritabanı adı, kullanıcı adı ve kullanıcının hangi veritabanına eklendiği listelenir.

2. cPanel Dosya Yöneticisi’nde public_html kökündeki wp-config.php dosyasını Kod Düzenleyici ile açın.WordPress’in resmî dokümantasyonuna göreDB_NAME, DB_USER, DB_PASSWORD ve DB_HOST satırlarının bir önceki adımda gördüğünüz değerlerle birebir aynı olduğunu karşılaştırın.
   

   

   Beklenen sonuç: dört değer de cPanel’de gördüğünüz veritabanı adı, kullanıcı adı ve sunucu adıyla birebir eşleşir; paylaşımlı hostingde DB_HOST satırı 'localhost' olmalıdır.

3. Bilgiler eşleşmiyorsa yalnız yanlış olan satırı düzeltin; doğru olanları elle yeniden yazıp yeni bir yazım hatası eklemeyin.

Yöntem 2 — Veritabanı kullanıcısını yetkilendirme ve şifre güncelleme

1. MySQL® Veritabanları sayfasında “Kullanıcıları Veritabanlarına Ekle” bölümünden kullanıcının bu veritabanına eklenip eklenmediğini kontrol edin; eklenmemişse ekleyip Tüm Ayrıcalıklar (All Privileges) ile onaylayın.

   Beklenen sonuç: kullanıcı adı veritabanının “Kullanıcılar” listesinde ve yanında tüm ayrıcalık kutucukları işaretli görünür.

2. Şifreyi cPanel’den değiştirdiyseniz ya da hatırlamıyorsanız aynı sayfadaki “Değiştir Şifre” bağlantısıyla yeni bir şifre belirleyin, ardından bu şifreyi wp-config.php‘deki DB_PASSWORD satırına aynen yazın.

Yöntem 3 — Taşıma sonrası bağlantı ayarlarını güncelleme

1. Siteyi başka bir hesaba ya da sunucuya taşıdıysanız yeni hesaptaki DB_HOST değerinin de paylaşımlı hostingde yine localhost olduğunu doğrulayın; eski sunucunun adı ya da IP’si dosyada kalmış olabilir.
2. wp-config.php‘deki $table_prefix satırının veritabanındaki gerçek tablo önekiyle (ör. wp_) aynı olduğunu phpMyAdmin’den tablo listesine bakarak kontrol edin; taşıma sırasında farklı bir önekle içe aktarılmış tablolar bu satırla eşleşmezse WordPress veritabanına bağlanır ama içeriği bulamaz.

   Beklenen sonuç: tablo listesindeki önek (ör. wp_posts) ile $table_prefix değeri birebir aynıdır.

Doğrulama

Hâlâ çözülmediyse

• Ekranda hâlâ “Error Establishing a Database Connection” görüyorsunuz. Yapılandırma doğruysa sorun sunucu kaynak sınırına takılmış olabilir; hata metnine göre yazılmış karta geçin.
• Bağlantı kuruluyor ama site “veritabanı hatası” ya da boş sayfa veriyor. Genelde tablo önekinin ($table_prefix) veritabanındaki gerçek önekle uyuşmamasıdır; Yöntem 3’ü tekrar kontrol edin.
• Şifreyi doğru yazdığınızdan eminsiniz ama hâlâ reddediliyor. Kopyala-yapıştır sırasında gizli boşluk ya da yanlış tırnak işareti kalmış olabilir; şifreyi cPanel’den tekrar sıfırlayıp doğrudan yazın.