WordPress "Veritabanı Bağlantısı Kurulurken Hata" Nasıl Çözülür?

WordPress sitenizi açtığınızda beyaz bir sayfada yalnızca "Veritabanı bağlantısı kurulurken hata" (İngilizce kurulumlarda "Error establishing a database connection") yazıyorsa, site dosyalarınız yerinde ama WordPress veritabanına ulaşamıyor demektir. İyi haber: içeriğiniz büyük ihtimalle kaybolmadı. Bu rehberde hatanın nedenlerini en sık olandan en nadire doğru sıraladık; cPanel'li bir hosting hesabında her birini nasıl kontrol edeceğinizi adım adım anlatıyoruz.

---

Hata Ne Anlama Geliyor?

WordPress her sayfa açılışında, wp-config.php dosyasında yazan bilgilerle MySQL veritabanına bağlanır. Bu dört bilgiden biri yanlışsa ya da veritabanı sunucusu isteğe yanıt veremiyorsa WordPress sayfayı oluşturamaz ve bu hatayı gösterir.

Hatanın en sık görüldüğü anlar:

• Site başka bir hosting firmasından taşındıktan hemen sonra.
• cPanel'de veritabanı kullanıcısının şifresi değiştirildikten sonra.
• Veritabanı ya da kullanıcı yanlışlıkla silindikten ya da yeniden adlandırıldıktan sonra.
• Hosting paketinin disk kotası dolduğunda.

---

Adım 1: wp-config.php'deki Bilgileri Kontrol Edin

cPanel'de Dosya Yöneticisi'ni açın, sitenizin klasörüne (genellikle public_html) gidin ve wp-config.php dosyasını düzenleyin. Şu dört satırı bulun:

define( 'DB_NAME', 'kullanici_wpveritabani' );
define( 'DB_USER', 'kullanici_wpkullanici' );
define( 'DB_PASSWORD', 'veritabani-sifresi' );
define( 'DB_HOST', 'localhost' );

Şimdi cPanel'de MySQL Veritabanları (MySQL Databases) sayfasını açın ve karşılaştırın:

• DB_NAME: "Mevcut Veritabanları" listesindeki adla birebir aynı olmalı.
• DB_USER: "Mevcut Kullanıcılar" listesindeki adla birebir aynı olmalı.
• DB_HOST: Aynı hosting hesabında çalışan siteler için localhost olmalı. Başka bir firmadan taşınan sitelerde bu satırda eski firmanın sunucu adresi kalmış olabilir.

Önek tuzağı

cPanel'de veritabanı ve kullanıcı adlarının başına cPanel kullanıcı adınız ve alt çizgi otomatik eklenir. wpdb adında bir veritabanı oluşturduysanız gerçek adı cpkullanici_wpdb olur. Site başka bir firmadan taşındıysa wp-config.php'de eski hesabın öneki kalmış olabilir; yeni hesabınızın önekiyle değiştirin.

---

Adım 2: Şifreyi Sıfırlayın

Şifrenin doğru olduğundan emin değilseniz en hızlı yol yeni bir şifre belirlemektir:

1. cPanel > MySQL Veritabanları sayfasında "Mevcut Kullanıcılar" listesinden kullanıcıyı bulun ve Parola Değiştir'e tıklayın.
2. Yeni bir şifre belirleyin ve kopyalayın.
3. wp-config.php dosyasında DB_PASSWORD satırını bu şifreyle güncelleyip kaydedin.

Şifrede tek tırnak (') ya da ters eğik çizgi (\) kullanmaktan kaçının; bu karakterler wp-config.php içinde satırı bozabilir.

---

Adım 3: Kullanıcının Veritabanı Yetkisini Kontrol Edin

Kullanıcı ve veritabanı ayrı ayrı var olabilir ama birbirine bağlanmamış olabilir. Bu durumda bilgiler doğru olsa bile bağlantı reddedilir.

1. cPanel > MySQL Veritabanları sayfasında aşağıdaki Veritabanına Kullanıcı Ekle bölümüne gelin.
2. Kullanıcıyı ve veritabanını seçip Ekle'ye tıklayın.
3. Açılan yetki ekranında TÜM AYRICALIKLAR kutusunu işaretleyip değişiklikleri kaydedin.

"Mevcut Veritabanları" tablosunda veritabanının yanındaki "Ayrıcalıklı Kullanıcılar" sütununda kullanıcınızı görüyorsanız bu adım tamamdır.

---

Adım 4: Disk Kotasını Kontrol Edin

Hosting paketinizin disk alanı dolduğunda MySQL yeni veri yazamaz ve WordPress bağlantı hatası verebilir. cPanel ana sayfasındaki sağ sütunda Disk Kullanımı göstergesine bakın. Doluluk %100'e yakınsa:

• Eski yedek dosyalarını (.zip, .tar.gz) ve kullanılmayan eklenti ya da temaları silin.
• E-posta kutularındaki büyük ekleri temizleyin; e-postalar da aynı kotayı kullanır.
• Yer açtıktan sonra siteyi yeniden deneyin. Kalıcı olarak yer yetmiyorsa üst pakete geçebilirsiniz.

---

Adım 5: Veritabanı Tablolarını Onarın

Bilgiler doğru, yetkiler tamam, disk boş ama hata sürüyorsa ya da yönetim panelinde "bir veya daha fazla veritabanı tablosu kullanılamıyor" gibi bir uyarı görüyorsanız tablolar bozulmuş olabilir. Bu durum genellikle ani bir kesinti ya da disk dolması sonrasında görülür.

cPanel üzerinden onarım

cPanel > MySQL Veritabanları sayfasında "Veritabanlarını Değiştir" bölümünden veritabanınızı seçip Veritabanını Onar'a tıklayın.

WordPress'in kendi onarım aracı

1. wp-config.php dosyasına, /* That's all, stop editing! */ satırının hemen üstüne şunu ekleyin:

define( 'WP_ALLOW_REPAIR', true );

2. Tarayıcıda https://alanadiniz.com/wp-admin/maint/repair.php adresini açın ve Veritabanını Onar düğmesine tıklayın.
3. İşlem bitince eklediğiniz satırı mutlaka silin. Bu sayfa açık kaldığı sürece herkes tarafından erişilebilir.

---

Adım 6: Taşınan Sitelerde Veritabanı Gerçekten Aktarıldı mı?

Site başka bir firmadan taşındıysa, dosyalar aktarılmış ama veritabanı içe aktarılmamış olabilir. cPanel > phpMyAdmin'i açın ve veritabanınızı seçin. Sol tarafta wp_options, wp_posts gibi tablolar görünmüyorsa veritabanı boştur. Eski hostinginizden aldığınız .sql yedeğini phpMyAdmin'deki İçe Aktar (Import) sekmesinden yükleyin.

Tablo adlarının başındaki önek (wp_ ya da farklı bir önek) ile wp-config.php dosyasındaki $table_prefix değeri de aynı olmalıdır. Farklıysa WordPress veritabanına bağlanır ama kurulum sayfasını açmaya çalışır.

Taşıma sürecinin tamamını WordPress site taşıma rehberimizde anlattık.

---

Hâlâ Çözülmediyse

Yukarıdaki adımların hepsi tamam olduğu hâlde hata sürüyorsa destek talebi açın ve şunları belirtin:

1. Sitenin alan adı.
2. Hatanın ne zaman başladığı ve öncesinde yapılan değişiklik (taşıma, şifre değişikliği, eklenti güncellemesi).
3. Hangi adımları denediğiniz.

Veritabanı şifrenizi talebe yazmanıza gerek yoktur.

---

Özet

1. wp-config.php'deki veritabanı adı, kullanıcı, şifre ve localhost değerini cPanel ile karşılaştırın.
2. cPanel'in eklediği kullanıcı adı önekine dikkat edin.
3. Emin değilseniz veritabanı kullanıcısının şifresini sıfırlayıp wp-config.php'ye yazın.
4. Kullanıcıyı veritabanına tüm yetkilerle ekleyin.
5. Disk kotasını kontrol edin, gerekirse yer açın.
6. Tabloları onarın; onarım satırını işiniz bitince silin.

LiteSpeed ve NVMe altyapısıyla WordPress için optimize edilmiş paketler için web hosting sayfamıza göz atabilirsiniz.