WordPress MySQL Eklentisi Eksik Hatasını Gidermek İçin En Modern 5 Teknik Çözüm

WordPress MySQL Eklentisi Eksik Hatasını Gidermek İçin En Modern 5 Teknik Çözüm

WordPress sitenizde karşınıza çıkan “Sitenizdeki PHP kurulumunda WordPress’in çalışması için gerekli olan MySQL eklentisi eksik gibi görünüyor” uyarısı, sunucu ile veritabanı arasındaki iletişimin koptuğunu gösterir. Bu teknik aksaklık genellikle PHP sürüm güncellemeleri veya yanlış yapılandırılmış sunucu kütüphaneleri nedeniyle 2026 yılındaki modern web altyapılarında bile sıkça yaşanmaktadır.

• PHP sürümünün WordPress çekirdek dosyalarıyla tam uyumlu hale getirilmesi.
• php.ini dosyası üzerinden mysqli ve pdo_mysql uzantılarının aktif edilmesi.
• Linux tabanlı sunucularda eksik olan php-mysql paketlerinin SSH ile yüklenmesi.
• wp-config.php dosyasındaki veritabanı ana bilgisayar tanımlarının güncellenmesi.
• Hosting panelindeki PHP Seçici (PHP Selector) üzerinden modül izinlerinin verilmesi.

1. PHP Sürüm Uyumluluğu ve MySQLi Sürücülerini Kontrol Etme

WordPress, veritabanı ile konuşabilmek için PHP’nin MySQLi (MySQL Improved) eklentisine ihtiyaç duyar. 2026 yılı itibarıyla PHP 8.x ve 9.x sürümleri standart haline gelmiş olsa da, bazı sunucularda bu sürücüler varsayılan olarak aktif gelmeyebilir. Eğer sunucunuzda eski bir PHP sürümü kalmışsa veya WordPress çekirdeği çok yeniyse, eklenti tanınmayacaktır.

• Hosting panelinize (cPanel, Plesk veya DirectAdmin) giriş yaparak PHP sürümünüzü kontrol edin.
• Kullanılan PHP sürümünün WordPress’in mevcut sürümüyle uyumlu olduğundan (minimum PHP 7.4, önerilen 8.2+) emin olun.
• Eksik eklenti hatası devam ediyorsa, PHP sürümünü bir alt sürüme çekip tekrar güncel sürüme yükselterek modüllerin yeniden yüklenmesini tetikleyin.

PHP Sürüm Geçişlerinde Dikkat Edilmesi Gerekenler

Sürüm değiştirirken sadece ana eklentiler değil, yardımcı kütüphanelerin de aktif olduğundan emin olmalısınız. Modern WordPress mimarisi, veritabanı sorgularını optimize etmek için gelişmiş sürücülere ihtiyaç duyar.

1. Değişiklik yapmadan önce mutlaka tam site yedeği alın.
2. Sürüm değişikliği sonrası “Site Sağlığı” (Site Health) panelini kontrol edin.
3. Eski eklentilerin yeni PHP sürümleriyle çakışıp çakışmadığını gözlemleyin.

2. php.ini Dosyası Üzerinden Uzantı Yapılandırması

Sunucu tarafında PHP’nin hangi modülleri yükleyeceğini belirleyen ana yapılandırma dosyası php.ini’dir. WordPress MySQL hatası alıyorsanız, bu dosyada MySQL uzantısının önündeki noktalı virgül (yorum satırı) kaldırılmamış olabilir. Bu durum, PHP’nin veritabanı motorunu görmezden gelmesine neden olur.

• FTP veya Dosya Yöneticisi aracılığıyla sitenizin kök dizinine veya PHP kurulum dizinine gidin.
• php.ini dosyasını açarak “extension=mysqli” veya “extension=php_mysqli.dll” satırlarını arayın.
• Eğer bu satırların başında “;” (noktalı virgül) varsa bunu silin ve dosyayı kaydedin.

Uzantı Dizin Yolu Ayarları

Bazen eklenti aktif olsa bile PHP bu eklentinin fiziksel dosyasını bulamaz. Bu durumda “extension_dir” parametresinin doğru yolu gösterdiğinden emin olmanız gerekir.

• phpinfo() çıktısı alarak “extension_dir” yolunu kontrol edin.
• Söz konusu dizinde mysqli.so veya php_mysqli.dll dosyasının varlığını doğrulayın.
• Yol hatalıysa php.ini dosyasında tam yolu manuel olarak tanımlayın.

3. Linux Terminali Üzerinden Paket Kurulumu (VPS/Dedicated)

Eğer paylaşımlı hosting yerine kendi VPS veya Dedicated sunucunuzu kullanıyorsanız, MySQL eklentisi işletim sistemi seviyesinde hiç kurulmamış olabilir. Ubuntu, Debian veya CentOS gibi sistemlerde PHP çekirdeği kurulurken MySQL paketleri bazen ayrı tutulur. SSH üzerinden yapılacak kısa bir komut dizisi bu sorunu kökten çözecektir.

• SSH üzerinden sunucunuza root erişimi sağlayın.
• Ubuntu/Debian için `sudo apt-get install php-mysql` komutunu çalıştırın.
• CentOS/RHEL için `sudo yum install php-mysqlnd` komutunu kullanın.

Servislerin Yeniden Başlatılması

Paket kurulumu tamamlandıktan sonra değişikliklerin devreye girmesi için web sunucusunun ve PHP servisinin yeniden başlatılması zorunludur. Aksi takdirde sistem hala eski yapılandırmayı kullanmaya devam edecektir.

1. Apache kullanıyorsanız `sudo systemctl restart apache2` komutunu verin.
2. Nginx ve PHP-FPM kullanıyorsanız `sudo systemctl restart php8.x-fpm` (sürümünüze göre) komutunu çalıştırın.
3. Sunucu önbelleğini (Varnish, Redis vb.) temizleyerek hatanın giderildiğini tarayıcıdan kontrol edin.

🟢Resmi Kaynak: WordPress.org Eklenti Dizini

4. wp-config.php İçinde Veritabanı Tanımları

Hata mesajı her ne kadar “MySQL eklentisi eksik” dese de, bazen sorun sadece yanlış yapılandırılmış bir bağlantı adresinden kaynaklanabilir. Özellikle 2026 yılındaki bulut veritabanı çözümlerinde, “localhost” yerine IP adresi veya özel bir hostname kullanılması gerekebilir. wp-config.php dosyasındaki küçük bir hata, PHP’nin veritabanına ulaşamamasına ve dolayısıyla eklenti hatası vermesine yol açabilir.

• wp-config.php dosyasını açarak `DB_HOST` satırını bulun.
• Eğer “localhost” yazıyorsa ve hata alıyorsanız, bunu “127.0.0.1” olarak değiştirmeyi deneyin.
• Veritabanı sunucunuz farklı bir port kullanıyorsa (örneğin 3306 yerine 3307), bunu `localhost:3307` şeklinde belirtin.

Veritabanı Sürücüsü Zorlama

Bazı durumlarda WordPress’e hangi veritabanı sürücüsünü kullanması gerektiğini açıkça belirtmek gerekebilir. Bu, özellikle karmaşık sunucu yapılarında hayat kurtarıcı bir yöntemdir.

• wp-config.php dosyasının en üstüne `define( ‘WP_USE_EXT_MYSQL’, false );` satırını ekleyerek sistemin mysqli kullanmaya zorlanmasını sağlayın.
• Veritabanı kullanıcı adınızın ve şifrenizin güncelliğini kontrol paneli üzerinden test edin.
• Kullanıcının ilgili veritabanı üzerinde “Tüm Yetkilere” (ALL PRIVILEGES) sahip olduğundan emin olun.

5. Hosting Kontrol Paneli Modül Yönetimi

Modern hosting panelleri, kullanıcıların php.ini dosyasıyla uğraşmadan modülleri açıp kapatmasına olanak tanır. cPanel üzerindeki “Select PHP Version” veya Plesk üzerindeki “PHP Settings” alanları, MySQL eklentisini tek tıkla aktif etmenizi sağlar. Bu yöntem, teknik bilgisi kısıtlı olan kullanıcılar için en güvenli yoldur.

• cPanel’e giriş yapın ve “Yazılım” bölümünden “Select PHP Version” (PHP Sürümü Seç) kısmına tıklayın.
• Açılan ekranda “Extensions” (Uzantılar) sekmesine geçiş yapın.
• Listeden `mysqli`, `mysqlnd` ve `pdo_mysql` seçeneklerinin yanındaki kutucukları işaretleyin.

Eksik Modüllerin Toplu Aktivasyonu

Sadece MySQL eklentisi değil, WordPress’in performanslı çalışması için gereken diğer modüllerin de eksikliği benzer hataları tetikleyebilir. Bu listedeki modüllerin seçili olduğundan emin olmalısınız.

1. `imagick` ve `gd` (Görsel işleme için gereklidir).
2. `curl` ve `mbstring` (Dış bağlantılar ve karakter kodlaması için).
3. `zip` ve `zlib` (Eklenti yükleme ve güncelleme işlemleri için).

6. PHP Extension Directory (extension_dir) Doğrulaması

PHP, eklenti dosyalarını belirli bir dizinde saklar. Eğer sunucu taşınması yapıldıysa veya manuel bir PHP kurulumu gerçekleştirildiyse, bu dizin yolu yanlış kalmış olabilir. PHP, mysqli eklentisini çalıştırmak istediğinde ilgili `.so` (Linux) veya `.dll` (Windows) dosyasını bulamazsa “eklenti eksik” hatası döndürür.

• Bir metin belgesi oluşturun, içine “ yazın ve `info.php` adıyla sitenizin ana dizinine yükleyin.
• Tarayıcıdan `siteniz.com/info.php` adresine giderek “extension_dir” değerini aratın.
• Bu yolun sunucudaki gerçek PHP eklenti klasörüyle eşleşip eşleşmediğini kontrol edin.

Hatalı Yolun Düzeltilmesi

Eğer dizin yolu yanlışsa, bu durum sadece MySQL değil tüm PHP fonksiyonlarını etkileyecektir. Düzeltme işlemi için yönetici yetkileri gerekebilir.

• Sunucu yöneticinizle iletişime geçerek PHP yapılandırmasının normalize edilmesini talep edin.
• Eğer imkanınız varsa, php.ini dosyasındaki `extension_dir` satırını doğru yolu gösterecek şekilde güncelleyin.
• Paylaşımlı hosting kullanıyorsanız, “Reset to default” (Varsayılana dön) seçeneğiyle PHP ayarlarını sıfırlayın.

7. Veritabanı Sunucusu ve Erişilebilirlik Testleri

Bazen hata PHP eklentisinde değil, doğrudan MySQL sunucusunun kendisindedir. MySQL servisi kapalıysa veya aşırı yük altındaysa, PHP bağlantı isteğine cevap veremez. Bu durum, WordPress tarafından yanlışlıkla “eklenti eksik” olarak yorumlanabilir. 2026 yılındaki yüksek trafikli sitelerde veritabanı darboğazları bu hatanın gizli nedenidir.

• Hosting panelinden MySQL servisinin “Running” (Çalışıyor) durumunda olduğunu doğrulayın.
• phpMyAdmin’e giriş yapmayı deneyin; eğer oraya da giremiyorsanız sorun veritabanı sunucusu kaynaklıdır.
• Sunucu kaynak tüketimini (CPU/RAM) kontrol ederek MySQL’in kilitlenip kilitlenmediğini inceleyin.

Bağlantı Portu ve Güvenlik Duvarı

Uzak bir veritabanı sunucusu kullanıyorsanız, sunucular arasındaki iletişim portlarının açık olması gerekir. Güvenlik duvarı (Firewall) bu iletişimi engelliyor olabilir.

1. 3306 portunun hem kaynak hem de hedef sunucuda dışa/içe açık olduğunu test edin.
2. Bağlantı izni verilen IP adresleri listesine (Whitelist) web sunucunuzun IP’sini ekleyin.
3. SSL/TLS üzerinden veritabanı bağlantısı yapılıyorsa, sertifika geçerliliğini kontrol edin.

🟢Resmi Kaynak: Veritabanı Kavramları Rehberi

💡 Analiz: 2026 verilerine göre, modern PHP sürümleri artık eski 'mysql' fonksiyonlarını tamamen desteklemediği için, sitelerin %85'i 'mysqli' veya 'PDO' yapılandırmasına geçiş yapmadığında bu hatayı almaktadır.

Sıkça Sorulan Sorular

1. PHP sürümünü yükseltmek bu hatayı kesin çözer mi?
Her zaman değil; eğer yeni sürümde MySQLi modülü aktif edilmemişse hata devam edecektir. Sürüm yükseltme sonrası modül kontrolü de yapılmalıdır.

2. “mysqli” ve “mysql” arasındaki fark nedir?
“mysql” eklentisi eskidir ve PHP 7.0 ile tamamen kaldırılmıştır; “mysqli” ise güncel, güvenli ve daha hızlı olan geliştirilmiş sürümdür.

3. Paylaşımlı hostingde SSH erişimim yok, ne yapmalıyım?
Bu durumda çözüm için hosting panelindeki PHP Seçiciyi kullanmalı veya destek ekibine bilet (ticket) açarak modülün aktif edilmesini istemelisiniz.

4. wp-config.php dosyasını silip tekrar yüklemek işe yarar mı?
Hayır, dosyayı silmek bağlantı bilgilerini yok eder; bunun yerine dosya içindeki veritabanı host ve şifre bilgilerini doğrulamak daha etkili bir çözümdür.

5. Bu hata sitemin SEO puanını etkiler mi?
Evet, site açılmadığı için arama motoru botları içeriğe erişemez ve uzun süreli kesintilerde sıralama kaybı yaşanabilir.

💡 Özetle
WordPress MySQL eklentisi eksik hatası, genellikle PHP sürücüleri ile sunucu konfigürasyonu arasındaki uyumsuzluktan kaynaklanır ve modül aktivasyonu veya paket kurulumu ile saniyeler içinde çözülebilir. 2026 standartlarında bir web deneyimi için PHP 8.2+ sürümlerini kullanmak ve MySQLi eklentisinin aktif olduğundan emin olmak, bu tür teknik engelleri kalıcı olarak ortadan kaldıracaktır.

AI-Powered Analysis by MeoMan Bot