WordPress “Veritabanı Bağlantısı Kurulurken Hata Oluştu” Kesin Çözümü

Sabah kahveni aldın, sitene bir bakayım dedin ve o da ne? Karşında Simsiyah ya da bomboş bir ekranda tek bir cümle: “Error Establishing a Database Connection”. Panik yok, siten silinmedi, hacklenmedin (muhtemelen). Sadece WordPress, veritabanının kapısını çalıyor ama içeriden cevap alamıyor. Aralarındaki bu küslüğü bitirmek için buradayım.

Bu rehberde, lafı dolandırmadan en basitinden en teknik adımına kadar bu sorunu nasıl kökten çözeceğimizi anlatacağım. Hazırsan PHP dosyalarına dalıyoruz.

Sorunun Kaynağını Anlamak: Neden Bu Hatayı Alıyorsun?

WordPress, içeriğini (yazılar, yorumlar, ayarlar) saklamak için bir MySQL veritabanı kullanır. Bu hata özünde şu üç şeyden biri demektir:

1. Kimlik Bilgileri Yanlış: Kapıyı yanlış anahtarla açmaya çalışıyorsun (DB_USER veya DB_PASSWORD hatalı).
2. Veritabanı Bozulmuş: Veritabanı “yorgun” ve onarılmaya ihtiyacı var.
3. Sunucu Yanıt Vermiyor: Veritabanı sunucun (localhost) şu an uykuda veya çökmüş durumda.

1. Adım: wp-config.php Dosyasını Kontrol Et (En Yaygın Hata)

Hataların %90’ı buradan kaynaklanır. FTP (FileZilla) veya hosting panelindeki Dosya Yöneticisi üzerinden sitenin kök dizinine git ve wp-config.php dosyasını sağ tıklayıp düzenle. Şu satırları bul:

define( 'DB_NAME', 'veritabanı_adınız' );
define( 'DB_USER', 'veritabanı_kullanıcı_adınız' );
define( 'DB_PASSWORD', 'parolanız' );
define( 'DB_HOST', 'localhost' );

define( 'DB_NAME', 'veritabanı_adınız' );
define( 'DB_USER', 'veritabanı_kullanıcı_adınız' );
define( 'DB_PASSWORD', 'parolanız' );
define( 'DB_HOST', 'localhost' );

Bu bilgilerin hosting panelindeki (cPanel/Plesk) MySQL bilgileriyle birebir aynı olduğundan emin ol. Küçük bir harf hatası veya fazladan bir boşluk bile her şeyi bozar.

Pro Tip: Eğer her şey doğru görünüyorsa DB_HOST kısmını localhost yerine IP adresiyle (genelde 127.0.0.1) değiştirmeyi dene. Bazı sunucular bunu sever.

2. Adım: WordPress Veritabanı Onarımı

Eğer ana sayfada bu hatayı alıyor ama /wp-admin sayfasına girmeye çalıştığında “Veritabanı onarılması gerekiyor” gibi farklı bir mesaj görüyorsan, şanslısın. WordPress bunu senin için yapabilir.

Yine wp-config.php dosyasını aç ve en alta şu satırı ekle: define('WP_ALLOW_REPAIR', true);

Ardından şu adrese git: siteniz.com/wp-admin/maint/repair.php. “Veritabanını Onar” butonuna bas. İşlem bitince eklediğin o kodu dosyadan silmeyi unutma, yoksa herkes veritabanını kurcalayabilir!

3. Adım: Veritabanı Kullanıcı İzinlerini Kontrol Et

Veritabanı adın ve şifren doğru olabilir ama kullanıcının o veritabanına erişme yetkisi olmayabilir.

• cPanel’e gir.
• “MySQL Veritabanları” kısmına gel.
• “Veritabanına Kullanıcı Ekle” bölümünden doğru kullanıcıyı ve veritabanını seçip “Ekle” de.
• Tüm yetkileri (ALL PRIVILEGES) işaretlediğinden emin ol.

4. Adım: MySQL Sunucusu Çökmüş Olabilir mi?

Eğer her şey doğruysa ve hala hata alıyorsan, sorun sende değil sunucundadır. Özellikle paylaşımlı hosting kullanıyorsan, trafik yoğunluğu nedeniyle MySQL servisi durmuş olabilir.

Bunu test etmek için basit bir kontrol yapalım. Sitenin ana dizinine test.php diye bir dosya oluştur ve içine şunu yapıştır:

<?php
$link = mysqli_connect('localhost', 'db_kullanici', 'db_sifre');
if (!$link) {
die('Bağlanamadı: ' . mysqli_error());
}
echo 'Bağlantı başarılı!';
mysqli_close($link);
?>

<?php
$link = mysqli_connect('localhost', 'db_kullanici', 'db_sifre');
if (!$link) {
die('Bağlanamadı: ' . mysqli_error());
}
echo 'Bağlantı başarılı!';
mysqli_close($link);
?>

Bu dosyayı tarayıcıda aç (siteniz.com/test.php). Eğer “Bağlanamadı” diyorsa, hosting firmana “MySQL servisi çalışmıyor, bir baksanıza” diye bir ticket atmanın vakti gelmiştir.

💡 Teknik İpucu (Expert Box)

Bunu biliyor muydunuz? Bazen bu hata, veritabanı prefix’i (tablo ön eki) yüzünden oluşur. Eğer veritabanını taşıdıysan veya yeni bir kurulum yaptıysan, wp-config.php içindeki $table_prefix = 'wp_'; satırının veritabanındaki tablolarla eşleştiğinden emin ol. Eğer tabloların wp_site_ ile başlıyorsa ama kodda wp_ yazıyorsa bağlantı kurulsa bile WordPress “Ben burada tablo bulamadım” diyerek hata verir.

Sonuç: Artık Yayındasın!

Bu adımları takip ettiysen, muhtemelen şu an siten aslanlar gibi çalışıyor olmalı. WordPress veritabanı hataları genellikle “basit bir yazım hatası” veya “sunucu kaynaklı geçici bir aksaklık” meselesidir. Eğer hala sorun yaşıyorsan, PHP sürümünü kontrol etmek veya son yüklediğin eklentileri (FTP üzerinden plugins klasörünün adını değiştirerek) devre dışı bırakmak iyi bir fikir olabilir.

Senin sorununu hangisi çözdü? Ya da daha garip bir hata mı alıyorsun? Yorumlara yaz, beraber çözelim. Siteportal.net’te kal, teknolojiden geri kalma!