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

WordPress sitenizde “Veritabanı bağlantısı kurulurken hata oluştu (Error establishing a database connection hatası)” mesajı görüyorsanız, bu hata, WordPress’in MySQL veritabanınıza erişemediği anlamına gelir. Veritabanı, tüm içeriklerinizin, kullanıcı bilgilerinizin, ayarlarınızın saklandığı dijital deponuzdur. WordPress’in bu depoya ulaşamaması, sitenizin tamamen çalışmaz hale gelmesi demektir. Ancak bu sorunun arkasında genellikle basit nedenler yatar ve adım adım ilerleyerek çözüme ulaşabilirsiniz.

Veritabanı Bağlantı Hatası – Error establishing a database connection Nedir?

WordPress,  site verilerini depolamak için bir veritabanı kullanır. Veritabanına bağlanmak için WordPress, wp-config.php dosyasında bulunan verilere ihtiyaç duyar (Veri tabanı ismi, Veritabanı kullanıcı adı, Veritabanı şifresi, Veritabanı sunucusu). Bu bilgilerin herhangi birinde sorun varsa, WordPress veritabanına bağlanamaz ve veritabanı bağlantısı hatasıyla karşılaşırsınız.

En sık görülen WordPress hatalarından biri olan “Veritabanı bağlantısı kurulurken hata oluştu” sorunu birkaç farklı nedenden kaynaklanabilir:

• Yanlış Veritabanı Bilgileri– En yaygın nedenlerden biri, wp-config.php dosyasındaki veritabanı adı, kullanıcı adı veya şifresinin yanlış olmasıdır. Hosting değişikliği sonrası özellikle sık görülür.
• Bozuk Veritabanı– Veritabanı tablolarınız zarar görmüş olabilir. Sunucu çökmesi, eklenti çakışması ya da başarısız güncellemeler bu duruma yol açar.
• Sunucu Sorunları– Hosting sağlayıcınızın sunucusunda yaşanan problemler, aşırı trafik yükü veya bakım çalışmaları veritabanı erişimini engelleyebilir.
• Hosting Limitleri– Paylaşımlı hosting paketlerinde veritabanı boyut limiti aşılmış veya eşzamanlı bağlantı sayısı dolmuş olabilir.

Hatanın hangi sayfada göründüğü de ipucu verir. Sadece ana sitenizde mi görünüyor, yoksa WordPress admin paneline giriş yaparken de mi karşınıza çıkıyor? Eğer hem ön yüzde hem admin panelde görünüyorsa, sorun büyük ihtimalle wp-config.php dosyanızda veya veritabanında. Ama sadece ön yüzde görünüyorsa, veritabanı tabloları hasar görmüş olabilir.

Veritabanı Bağlantı Hatası Nasıl Çözülür?

Bu ciddi bir hata olmasına rağmen neyse ki, çözülmesi oldukça kolaydır. Aşağıda, sorunu gidermeye yönelik adım adım talimatlar bulacaksınız. Her adımı sırayla denemeniz gerektiğini, yalnızca biri işe yaramazsa bir sonrakine geçmeniz gerektiğini unutmayın. Şimdi, “Veritabanı bağlantısı kurulurken hata oluştu – Error establishing a database connection sorununun çözümü için neler yapılabileceğine göz atalım.

# Hosting Firmanızla İletişime Geçin

Eğer herhangi bir işlem yapma konusunda kendinizi yetersiz hissediyorsanız, web sitenizle ilgili yaşadığınız herhangi bir sorun için ilk olarak hosting firmanızla görüşmenizi öneririz. Bu size zaman kazandıracaktır.

“Veritabanı bağlantısı kurulurken hata oluştu” sorunuyla karşılaştığınızı hostunuza bildirin ve bu konuda nasıl bir yol izleyebileceğinizi sorun. Çoğu durumda, ya hatanın tam olarak nereden kaynaklandığını bildirirler ya da sizin yerinize bu hataya neden olan sorunu düzeltirler. Ani trafik veya sunucu taraflı bir sorun yoksa ve işlemleri sizin yerinize yapma hizmeti sunmuyorlarsa aşağıdaki adımlara geçebilirsiniz.

# Veritabanı Kimlik Bilgilerinizi Kontrol Edin

WordPress’teki veritabanı hataları nedenlerinden biri yanlış veritabanı kimlik bilgileridir. Normalde bu tür bilgiler kendiliğinden değişmez, ancak barındırma ortamında ya da site dosyalarında yaptığınız herhangi bir değişiklik bu hatayla karşılaşmanıza neden olabilir.

📌 Herhangi bir değişiklik yapmadan önce sitenizi yedeklemeyi unutmayın!

• wp-config.php dosyasına erişmek için FTP programı (FileZilla gibi) veya hosting kontrol panelinizin dosya yöneticisini kullanabilirsiniz. Dosya, WordPress’in ana dizininde bulunur – yani public_html klasörünün hemen içinde. Dosyayı bulduğunuzda, sağ tıklayıp “Düzenle” veya “Edit” seçeneğini kullanarak açın. wp-config.php dosyanızı açtıktan sonra aşağıdaki satırları bulun.

define('DB_NAME', 'veritabani_adi');
define('DB_USER', 'veritabani_kullanici');
define('DB_PASSWORD', 'veritabani_sifresi');
define('DB_HOST', 'localhost');

• Bu dört satır büyük öneme sahiptir. DB_NAME veritabanınızın adını, DB_USER veritabanı kullanıcı adınızı, DB_PASSWORD şifrenizi ve DB_HOST veritabanı sunucunuzun adresini belirtir. Çoğu hosting için DB_HOST değeri ‘localhost’ olarak kalır, ancak bazı hosting sağlayıcılar farklı bir adres kullanır.
• Bu bilgilerin doğru olup olmadığını kontrol etmek için hosting kontrol panelinize (cPanel, Plesk vb.) giriş yapın ve “MySQL Veritabanları” veya “Veritabanı Yönetimi” bölümünü bulun. Orada veritabanı adınızı, kullanıcı adınızı ve host bilginizi görebilirsiniz. Bilgiler wp-config.php dosyanızdaki bilgilerle uyumluysa bu adımı atlayın. Değilse, wp-config.php’deki bilgileri doğru veritabanı bilgileriyle düzenleyin ve sorunun düzelip düzelmediğini kontrol edin. Şifreyi göremezseniz, yeni bir şifre belirleyip wp-config.php dosyasını buna göre güncelleyebilirsiniz.
• Hala sorun yaşıyorsanız veritabanı bağlantısını test etmek için kök dizinde (public_html) yeni bir dosya oluşturup aşağıdaki kodları girerek bir test başlatın (Dosyanızı db_test.php gibi istediğiniz şekilde adlandırabilirsiniz).

<?php
$link = mysql_connect('localhost', 'db_user', 'db_password');
if (!$link) {
die('Could not connect: ' . mysql_error());
}
echo 'Connected successfully';
mysql_close($link);
?>

• Db_user ve db_password değerlerini wp-config.php dosyanızdaki kendi bilgilerinizle değiştirmeyi unutmayın. Kontrol için tarayıcınıza şunu girin:  websiteniz.com/db_test.php
• Bağlantı başarısız olduysa kullanıcı adı ve şifreniz hatalı demektir. Bilgilerinizi tekrar gözden geçirebilir ve gerekirse yeni bir veritabanı oluşturup yeni şifre atayabilirsiniz. Daha sonra bilgileri wp-config.php dosyanızdan güncellemeyi unutmayın.

Çoğu WordPress kullanıcısı DB_HOST değerini göz ardı eder çünkü genellikle ‘localhost’ olarak kalır ve sorun çıkarmaz. Ancak bazı hosting sağlayıcıları, özellikle yönetimli WordPress hostingleri veya VPS sunucular, farklı bir host adresi kullanır. Bu durumda ‘localhost’ yerine IP adresi veya farklı bir sunucu adı gerekebilir.

• Bazı popüler hosting sağlayıcılarının kullandığı farklı DB_HOST değerleri:
  • localhost – En yaygın kullanılan standart değer
  • 127.0.0.1 – localhost’un IP karşılığı
  • mysql.site.com – Harici veritabanı sunucusu
  • 192.168.x.x – Lokal ağ IP adresi
• Doğru Değeri Nasıl Bulursunuz?
  • Hosting kontrol panelinizde “Veritabanı” bölümüne gidin. Orada “Host” veya “Server” başlığı altında doğru adresi bulabilirsiniz. Eğer bulamıyorsanız, hosting destek ekibinize sorun – bu bilgiyi size hemen vereceklerdir.

DB_HOST değerini değiştirdikten sonra mutlaka dosyayı kaydedin ve birkaç dakika bekleyin. Bazen değişikliklerin etkili olması biraz zaman alabilir. Sitenizi yenilediğinizde hala aynı hatayı alıyorsanız, bir sonraki adıma geçin.

# Veritabanını Onarın

Bazen veritabanınızdaki tablolar zarar görür ve bu da bağlantı hatasına yol açar. Neyse ki WordPress, otomatik onarım özelliği sunar.

• Veritabanı onarımını başlatmak için wp-config.php dosyanızı açın ve “/* That’s all, stop editing! */” satırının hemen üstüne şu kodu ekleyin:

define('WP_ALLOW_REPAIR', true);

• Bu kodu ekledikten sonra dosyayı kaydedin. Şimdi tarayıcınızda şu adrese gidin: http://siteniz.com/wp-admin/maint/repair.php

• Görseldeki gibi bir sayfa açılacak. Bu iki seçenekten İkincisini kullanmanızı öneririz çünkü hem sorunu çözer hem de veritabanınızın performansını artırır. Onarım işlemi veritabanınızın boyutuna bağlı olarak birkaç saniye ile birkaç dakika arasında sürebilir. İşlem tamamlandığında, yeşil tik işaretleri göreceksiniz ve “Repairs complete” mesajı alacaksınız. İşlem tamamlanınca güvenlik sebebiyle  wp-config.php dosyanıza eklediğiniz satırı kaldırmayı unutmayın.
• Bu işlemi wp-config.php dosyasına komut satırı eklemeden cPanel MySQL veritabanları bölümünden de gerçekleştirebilirsiniz.

• Bir diğer veritabanı onarım yöntemi ise şu;
  • Hosting kontrol panelinizden phpMyAdmin‘i açın ve WordPress veritabanınızı seçin.
  • “Tümünü seç” kutusunu işaretleyerek tüm tabloları seçin. Genellikle sayfa altında bulunur.
  • Açılır menüden “Repair table” (Tabloyu onar) seçeneğini seçin ve uygulayın.
  • Her tablo için “OK” veya “Table is already up to date” mesajı görmelisiniz.
  • Onarım işlemi sırasında bazı tablolarda hata mesajları görebilirsiniz. Endişelenmeyin – bu normaldir. Önemli olan, işlem sonunda çoğu tablonun “OK” durumunda olmasıdır. Eğer birkaç tablo hala sorunluysa, onları tek tek seçip tekrar onarım deneyebilirsiniz.
• phpMyAdmin’de iken bir de “Optimize table” (Tabloyu optimize et) işlemini yapmanızı öneririz. Bu işlem, veritabanınızdaki gereksiz verileri temizler ve performansı artırır. Tüm tabloları seçtikten sonra açılır menüden “Optimize table” seçeneğini seçmeniz yeterlidir.

# Eklenti ve Temanızı Kontrol Edin

Yeni bir eklenti ya da tema yükledikten sonra veya mevcut olanları güncelledikten sonra “Error establishing a database connection gibi bir sorunla karşılaşmış olabilirsiniz. Böyle bir durum söz konusuysa, tüm eklentileri devre dışı bırakıp ve mevcut temanızı varsayılan bir temayla değiştirip sorunun çözülüp çözülmediğini kontrol edin. Eğer sorun ortadan kalkmışsa buna neden olan eklenti ve temayı değiştirmeyi veya geliştiriciden destek talep etmeyi düşünebilirsiniz.

# Nadir Ama Olası Senaryolar

• Veritabanı Kullanıcı İzinleri– Bazen veritabanı kullanıcısının yeterli izni olmayabilir. phpMyAdmin’de veya cPanel’de, veritabanı kullanıcısına TÜM İZİNLER (ALL PRIVILEGES) verildiğinden emin olun. Özellikle yeni bir veritabanı oluşturduysanız bu adımı kontrol edin.
• wp_options Tablosu Sorunları– wp_options tablosu çok büyüdüğünde veya bozulduğunda bu hata oluşabilir. phpMyAdmin’den bu tabloyu özel olarak onarın ve gerekirse transient’leri temizleyin. WP-Sweep gibi eklentiler bu işlemi kolaylaştırır.
• max_connections Limiti– MySQL sunucusunun eşzamanlı bağlantı limiti dolmuş olabilir. Bu genellikle hosting tarafında çözülmesi gereken bir sorundur. Destek ekibiyle iletişime geçin ve max_connections değerinin artırılmasını isteyin.
• Socket Bağlantı Sorunları– Bazı sunucularda MySQL socket dosyası farklı konumda olabilir. wp-config.php’de DB_HOST olarak şunu deneyin: localhost:/var/lib/mysql/mysql.sock (sunucuya göre yol değişebilir).

# WP Dosyalarını Yeniden Yükleyin

Veritabanı bağlantı hatasının bir diğer olası nedeni, WordPress dosyalarınızdaki bir bozulma olabilir. Böyle bir durumda temiz dosyaları yüklemek sorunu çözebilir.

Temel olarak sitenizdeki WordPress çekirdek sürümünü değiştireceksiniz. Dolayısıyla eklentilere, temalara veya görsellere dokunmayacaksınız. Bunu yapmak için, WordPress’in en son sürümünü indirin. Bu dosyayı bilgisayarınızda açın, ardından wp-content klasörünü ve wp-config-sample.php dosyasını bulup silin. Diğer dosyaları FileZilla gibi bir FTP programıyla sitenize yükleyip mevcut dosyaların üzerine yazın. Bu işlem, tüm sorunlu dosyaları değiştirecek ve temiz ve bozulmamış yeni dosyalara sahip olmanızı sağlayacaktır. İşlemin ardından sitenizin önbelleğini temizleyin ve sorunun çözülüp çözülmediğini kontrol edin.

Yukarıdaki çözüm yollarının hiçbiri “Veritabanı bağlantısı kurulurken hata oluştu” sorunu için çözüm olmadıysa, web sitenizin en güncel yedeğini geri yüklemeyi de deneyebilirsiniz. Bununla birlikte, sunucunuzla alakalı bir sorun olma ihtimaline karşın hosting firmanızla görüşmenizi şiddetle tavsiye ederiz.