cPanel'de Veritabanı Adı, Kullanıcı Adı ve Şifresi Nereden Bulunur?

Siteyi başka bir sunucuya taşıyorsunuz, yedekten dönüyorsunuz ya da ekranda "Veritabanı bağlantısı kurulamadı" yazısını görüyorsunuz ve size sorulan ilk şey hep aynı: veritabanı adı, kullanıcı adı ve şifresi ne? Bu üç bilgi — dördüncüsü sunucu adı — sitenizin içeriğine açılan tek kapıdır. Yazıların, ürünlerin, siparişlerin, yorumların hepsi dosyalarda değil veritabanında durur; dosyalar sadece o veritabanına nasıl bağlanılacağını bilen koddur. Dolayısıyla bu dört değer yanlışsa site açılmaz, doğruysa her şey yerli yerinde görünür.

Bu yazıda bu bilgileri nerede bulacağınızı tek tek göstereceğim: WordPress'in wp-config.php dosyasında, WordPress dışındaki uygulamaların yapılandırma dosyalarında ve cPanel'in MySQL Veritabanları ekranında. Ama asıl önemli kısım orası değil. Yıllardır gördüğüm en yaygın sorun, insanların bilgileri buluyor olması ama şifrenin yanlış olması, kullanıcının veritabanına hiç atanmamış olması ya da localhost yazması gereken yere sunucu adı yazılması. Bu üç durumun her birinin belirtisi farklıdır ve çözümü de farklıdır — hepsini sırayla ele alacağız.

Veritabanı Bağlantısı İçin Gereken Dört Bilgi#

Bir MySQL/MariaDB bağlantısı için her zaman dört parça gerekir; üçünü bilip dördüncüsünü atlarsanız bağlantı yine kurulmaz.

Buradaki en kritik nokta önek meselesidir. cPanel'de veritabanı oluştururken kutuya wp01 yazarsınız ama gerçek ad kullanici_wp01 olur; kullanici_ kısmı cPanel hesabınızın kullanıcı adıdır ve panel bunu otomatik başa ekler. Aynısı veritabanı kullanıcısı için de geçerlidir. Bu yüzden yapılandırma dosyasına wp01 yazarsanız bağlantı asla kurulmaz — sunucuda öyle bir veritabanı yoktur. Tek istisna, kendi sunucunuzda panelsiz kurduğunuz MySQL'dir; orada önek yoktur, adı ne verdiyseniz odur.

Veritabanının kendisinin ne olduğu, tabloların nasıl durduğu konusunda temel bir boşluk hissediyorsanız veritabanı nedir yazısı bu yazının altyapısını kurar.

WordPress'te Veritabanı Bilgileri: wp-config.php#

WordPress'te dört bilginin tamamı sitenin kök dizinindeki wp-config.php dosyasında, düz metin olarak durur. Dosyayı cPanel → Dosya Yöneticisi → public_html yolunda bulur, üstüne sağ tıklayıp Düzenle'yi seçersiniz. İlk yirmi satırda şu bloğu görürsünüz:

/** WordPress için veritabanı adı */
define( 'DB_NAME', 'kullanici_wp01' );

/** MySQL veritabanı kullanıcı adı */
define( 'DB_USER', 'kullanici_wpuser' );

/** MySQL veritabanı şifresi */
define( 'DB_PASSWORD', 'd7#Kq2vRz!9m' );

/** MySQL sunucu adı */
define( 'DB_HOST', 'localhost' );

Dört satır, dört bilgi. $table_prefix satırı da hemen altındadır ve genelde wp_ yazar; taşıma sırasında bunu da not almanız gerekir, çünkü veritabanındaki tablo adları bu önekle başlar ve yeni kurulumda öneki değiştirirseniz WordPress "kurulum yapılmamış" der.

Dosyayı Dosya Yöneticisi'nde göremiyorsanız iki ihtimal var. Birincisi gizli dosyalar kapalıdır — Dosya Yöneticisi'nin sağ üstündeki Ayarlar düğmesinden "Gizli Dosyaları Göster" seçeneğini işaretleyin. İkincisi WordPress alt dizindedir; public_html/wp-config.php yerine public_html/blog/wp-config.php gibi bir yolda olabilir. Kök dizinde wp-content klasörünü gördüğünüz yer doğru yerdir.

FTP ile bakıyorsanız aynı dosyayı indirip herhangi bir metin düzenleyiciyle açabilirsiniz — ama Word ile açmayın, biçimlendirme ekler ve dosyayı bozar. Notepad++, VS Code ya da cPanel'in kendi editörü uygun seçeneklerdir.

Bu dosyanın hangi ek güvenlik önlemlerini alması gerektiğini merak ediyorsanız wp-config güvenlik ayrı bir konudur; buradaki asıl mesele, dosyanın şifreyi düz metin tutmasıdır ve bu normaldir — PHP'nin veritabanına bağlanabilmesi için başka yolu yoktur.

WordPress Dışındaki Uygulamalarda Dosya Nerede#

Türkçe kaynakların neredeyse tamamı wp-config.php gösterip bitiriyor. Oysa OpenCart, Joomla, Laravel ya da kendi yazdığınız bir PHP betiği de aynı bilgilere ihtiyaç duyar, sadece dosyanın adı ve söz dizimi değişir.

OpenCart'ta sık yapılan hata, sadece kök dizindeki config.php dosyasını düzenleyip admin/config.php dosyasını unutmaktır; sonuç olarak site ön yüzü açılır ama yönetim paneline girilemez. Laravel'de ise .env dosyası gizli dosyadır, Dosya Yöneticisi'nde "Gizli Dosyaları Göster" açık değilse hiç görünmez.

Kendi yazdığınız bir betikte ise bilgiler genellikle betiğin en üstünde $db_host, $db_user gibi değişkenlerde ya da ayrı bir db.php / ayarlar.php dosyasında durur; arama yaparken mysqli_connect veya new PDO ifadesini aratmak sizi doğrudan o satıra götürür.

cPanel'de Veritabanı Adını ve Kullanıcı Adını Bulma#

Yapılandırma dosyasına erişemiyorsanız ya da dosyadaki değerlerin gerçekten sunucuda var olup olmadığını doğrulamak istiyorsanız kaynak cPanel'dir.

1. cPanel'e girin.
2. Veritabanları bölümünde MySQL® Veritabanları'na tıklayın.
3. Sayfayı biraz aşağı kaydırın: Geçerli Veritabanları başlığı altında hesabınızdaki tüm veritabanları listelenir. Ad sütununda tam ad yazar — kullanici_wp01 gibi, önekiyle birlikte.
4. Aynı tablonun "Yetkili Kullanıcılar" sütununda, o veritabanına erişebilen kullanıcılar görünür. Bu sütun boşsa sorununuz zaten burada demektir; bir sonraki bölüme geçin.
5. Daha aşağıda Geçerli Kullanıcılar listesi var; sunucuda tanımlı tüm veritabanı kullanıcılarını orada görürsünüz.

Birden fazla site barındırıyorsanız hangi veritabanının hangi siteye ait olduğunu ad karışıklığından anlamayabilirsiniz. Bu durumda phpMyAdmin'e girin, sol taraftan veritabanını seçin, wp_options tablosunu açın ve siteurl satırına bakın; orada hangi alan adının yazdığını görürsünüz. Bu, kimin kim olduğunu bulmanın en hızlı yoludur. phpMyAdmin'de yolunuzu bulmakta zorlanıyorsanız phpMyAdmin kullanımı ekran ekran anlatıyor.

Veritabanı Şifresi Neden Görünmez ve Nasıl Sıfırlanır#

Veritabanı şifresi cPanel'de hiçbir ekranda yazmaz — çünkü MySQL şifreyi düz metin olarak saklamaz, karma (hash) hâlinde tutar ve karma geri çevrilemez. Yani "şifreyi unuttum, panelden bakayım" diye bir seçenek yoktur. Yapabileceğiniz tek şey yeni bir şifre atamaktır.

Doğru sıra şudur:

1. cPanel → MySQL® Veritabanları → Geçerli Kullanıcılar listesinden ilgili kullanıcının yanındaki Şifreyi Değiştir bağlantısına tıklayın.
2. Açılan ekranda yeni şifreyi iki kez girin. Şifre Üreticisi düğmesini kullanabilirsiniz; ürettiği şifreyi mutlaka bir yere kopyalayın, pencere kapandıktan sonra tekrar gösterilmez. Kendi şifrenizi yazacaksanız şifre üretici aracıyla güçlü bir değer üretebilirsiniz.
3. Şifreyi Değiştir ile kaydedin.
4. Şimdi yapılandırma dosyasına dönün ve DB_PASSWORD satırındaki değeri yeni şifreyle değiştirin. Bu adımı atlarsanız site açılmaz — şifreyi sunucuda değiştirip dosyada eskisini bıraktığınız için hata mesajı değişmez, hatta kötüleşir.

Şifrede kaçınmanız gereken karakterler var: tek tırnak ('), çift tırnak ("), ters bölü (\) ve dolar işareti ($). Bunlar PHP dosyasında dize sınırlarını bozar ya da değişken olarak yorumlanır. d7#Kq2vRz!9m gibi bir şifre sorunsuzdur; pas'sw$rd gibisi PHP sözdizimi hatası verir ve site komple beyaz ekrana düşer.

Şifreyi değiştirdikten sonra ilk kontrol her zaman phpMyAdmin'dir: cPanel → phpMyAdmin açılıyorsa MySQL servisi çalışıyor demektir, sorun kimlik bilgilerindedir.

Kullanıcı Veritabanına Atanmamışsa: Add User to Database#

Bu, Türkçe kaynakların neredeyse hiç değinmediği ama en sık rastladığım tuzaktır. cPanel'de veritabanı oluşturmak ve veritabanı kullanıcısı oluşturmak iki ayrı işlemdir. Üçüncü bir işlem daha vardır: kullanıcıyı veritabanına atamak. Bu üçüncü adım yapılmazsa kullanıcı adı da şifre de doğrudur ama o kullanıcının o veritabanına yetkisi yoktur ve MySQL bağlantıyı reddeder.

Belirti şudur: WordPress "Veritabanı bağlantısı kurulamadı" der ama wp-config.php içindeki her şey harfi harfine doğrudur. Kontrol etmenin yolu, cPanel → MySQL Veritabanları ekranında Geçerli Veritabanları tablosunda ilgili satırın "Yetkili Kullanıcılar" sütununa bakmaktır. Orası boşsa teşhis kesindir.

Çözüm:

1. Aynı sayfada Veritabanına Kullanıcı Ekle bölümüne inin.
2. Soldaki açılır listeden kullanıcıyı, sağdakinden veritabanını seçin.
3. Ekle düğmesine basın.
4. Açılan yetki ekranında TÜM AYRICALIKLAR kutusunu işaretleyin ve Değişiklikleri Yap deyin.

WordPress ve benzeri uygulamalar için tüm ayrıcalıklar normaldir; uygulama tablo oluşturur, değiştirir, siler. Yetkileri daraltmak isterseniz hangi ayrıcalığın ne işe yaradığı MySQL kullanıcı yetkileri yazısında tek tek açıklanıyor — ama uygulamanın kurulum ve güncelleme adımlarını kırmamak için ALTER, CREATE, DROP ve INDEX yetkilerini kesmeyin.

Sunucu Adı Ne Zaman localhost Olmaz#

DB_HOST değeri paylaşımlı hostingde neredeyse her zaman localhost'tur; çünkü web sunucusu ile MySQL aynı makinede çalışır ve bağlantı yerel soket üzerinden kurulur. Ama üç durumda değişir:

Veritabanı ayrı sunucudaysa. Bazı kurulumlarda MySQL ayrı bir makinede durur. O zaman host alanına o makinenin IP adresi ya da sunucu adı yazılır. Bu bilgiyi tahmin edemezsiniz, hosting sağlayıcınızın verdiği değerdir.

Uzaktan bağlanıyorsanız. Bilgisayarınızdaki bir masaüstü uygulamasından ya da başka bir sunucudan bağlanacaksanız localhost yazamazsınız — çünkü o "localhost" sizin kendi bilgisayarınızı işaret eder. Sunucunun IP adresini yazmanız ve ayrıca cPanel → Uzak MySQL ekranında kendi IP adresinizi izin listesine eklemeniz gerekir. Bu iki adımdan biri eksikse bağlantı zaman aşımına düşer. Ayrıntılar için uzaktan MySQL bağlantısı yazısına bakın.

Port farklıysa. Standart MySQL portu 3306'dır. Farklı bir port kullanılıyorsa host alanını 127.0.0.1:3307 biçiminde yazarsınız. Paylaşımlı hostingde bu neredeyse hiç olmaz, kendi VDS'inizde olabilir.

Bir ayrıntı daha: localhost ile 127.0.0.1 PHP'de aynı şey değildir. localhost yazarsanız PHP Unix soketi kullanır, 127.0.0.1 yazarsanız TCP üzerinden bağlanır. Soket yolu yanlış yapılandırılmış bir sunucuda localhost çalışmaz ama 127.0.0.1 çalışır. Elinizdeki bilgiler doğruyken hâlâ bağlanamıyorsanız denemeye değer tek satırlık bir değişikliktir.

Bağlantıyı Test Etme: Üç Yöntem#

Bilgileri topladıktan sonra siteyi düzeltmeden önce test edin; böylece hatanın kimlik bilgilerinde mi başka yerde mi olduğunu ayırt edersiniz.

1. phpMyAdmin ile. cPanel → phpMyAdmin. Buraya giriş yapabiliyorsanız MySQL ayakta demektir. Ancak dikkat: cPanel phpMyAdmin'e sizi cPanel kullanıcısıyla sokar, veritabanı kullanıcısıyla değil. Yani bu test kimlik bilgilerinizi doğrulamaz, sadece servisi doğrular.

2. Küçük bir PHP betiğiyle. public_html içine dbtest.php adında bir dosya oluşturun:

<?php
$host = 'localhost';
$db   = 'kullanici_wp01';
$user = 'kullanici_wpuser';
$pass = 'yeni_sifreniz';

$mysqli = @new mysqli($host, $user, $pass, $db);
if ($mysqli->connect_errno) {
    echo "HATA " . $mysqli->connect_errno . ": " . $mysqli->connect_error;
} else {
    echo "Baglanti basarili. Sunucu: " . $mysqli->server_info;
}

Tarayıcıdan siteadresiniz.com/dbtest.php adresine gidin. Testi bitirir bitirmez bu dosyayı silin — içinde açık şifre var ve URL'yi bilen herkes okuyabilir.

3. SSH varsa komut satırından. Sunucuya SSH erişiminiz varsa en hızlı yol budur:

mysql -u kullanici_wpuser -p kullanici_wp01

Şifreyi sorar, girersiniz. mysql> istemcisi açıldıysa dört bilginin dördü de doğrudur.

Hata Mesajlarının Anlamı#

Test sırasında aldığınız mesaj, hangi bilginin yanlış olduğunu doğrudan söyler. Bu tablo, teşhis süresini dakikalardan saniyelere indirir:

Access denied ... (using password: YES) mesajı listenin en sık görülenidir ve iki farklı nedenden gelir — yanlış şifre ya da atanmamış kullanıcı. İkisini ayırt etmenin yolu yukarıdaki cPanel "Yetkili Kullanıcılar" sütununa bakmaktır. Bu hatanın 1045 kodlu hâliyle karşılaşıyorsanız MySQL access denied 1045 hatası yazısı senaryoları ayrıntılandırıyor.

WordPress özelinde ekranda çıkan "Veritabanı bağlantısı kurulamadı" sayfasının tüm nedenlerini görmek isterseniz WordPress veritabanı bağlantı hatası yazısı bu yazının doğal devamıdır.

Bilgileri Bulduktan Sonra Güvenlik#

Veritabanı bilgilerini bulup düzelttikten sonra iki şeyi ihmal etmeyin.

Birincisi, test için oluşturduğunuz dosyaları silin. dbtest.php, info.php, phpinfo.php gibi dosyalar sunucuda kalırsa saldırganlara doğrudan bilgi verir. Aynı şey wp-config.php.bak, wp-config-eski.php gibi yedek kopyalar için de geçerlidir: .php uzantısı olmayan bir yedek dosyası tarayıcıdan düz metin olarak okunur ve şifreniz internete açılır. Yedek almak istiyorsanız dosyayı web kök dizininin dışına taşıyın.

İkincisi, veritabanı şifresini değiştirdiyseniz aynı şifreyi başka hiçbir yerde kullanmayın. Veritabanı kullanıcısının tek işi o veritabanına bağlanmaktır; cPanel şifreniz, FTP şifreniz ve e-posta şifreniz ondan farklı olmalıdır. Bir hesap ele geçirildiğinde zararın tek veritabanıyla sınırlı kalmasını sağlayan şey budur.

Sıkça Sorulan Sorular#

Veritabanı şifresini cPanel'den görebilir miyim#

Hayır, göremezsiniz; MySQL şifreleri geri çevrilemez biçimde saklandığı için hiçbir panel size mevcut şifreyi gösteremez. Yapabileceğiniz tek şey MySQL Veritabanları ekranından ilgili kullanıcıya yeni bir şifre atamaktır. Şifreyi değiştirdikten sonra uygulamanın yapılandırma dosyasındaki değeri de güncellemeyi unutmayın, aksi hâlde site açılmaz. Eğer şifre bir yerde yazılıysa, o yer büyük ihtimalle wp-config.php gibi bir yapılandırma dosyasıdır.

wp-config.php dosyasını bulamıyorum ne yapmalıyım#

Önce cPanel Dosya Yöneticisi'nin sağ üstündeki Ayarlar bölümünden "Gizli Dosyaları Göster" seçeneğini işaretleyin. Dosya hâlâ yoksa WordPress muhtemelen public_html altında değil, bir alt klasörde kuruludur; wp-content ve wp-admin klasörlerini gördüğünüz dizin doğru dizindir. Bazı kurulumlarda dosya güvenlik amacıyla bir üst dizine taşınmış olabilir, o zaman kök dizinin bir üstüne bakın. Hiçbir yerde yoksa site WordPress değildir ve başka bir yapılandırma dosyası aramanız gerekir.

Veritabanı adının başındaki kullanıcı adı öneki neden var#

Paylaşımlı hostingde aynı MySQL sunucusunda yüzlerce hesabın veritabanı bulunur ve isim çakışmasını önlemek için cPanel her ada hesap kullanıcı adını önek olarak ekler. Yani panele wp01 yazsanız da gerçek ad kullanici_wp01 olur. Yapılandırma dosyasına mutlaka önekli tam adı yazmalısınız. Kendi sunucunuzda panel kullanmadan kurduğunuz MySQL'de böyle bir önek yoktur.

Kullanıcı adı ve şifre doğru olduğu hâlde neden bağlanamıyorum#

En olası neden, kullanıcının o veritabanına atanmamış olmasıdır; cPanel'de veritabanı oluşturmak, kullanıcı oluşturmak ve kullanıcıyı veritabanına eklemek üç ayrı işlemdir. MySQL Veritabanları ekranında ilgili veritabanının "Yetkili Kullanıcılar" sütununa bakın, boşsa "Veritabanına Kullanıcı Ekle" bölümünden kullanıcıyı ekleyip tüm ayrıcalıkları verin. İkinci olasılık şifrede tek tırnak veya dolar işareti gibi PHP'de sorun çıkaran bir karakter bulunmasıdır. Üçüncüsü, host değerinin localhost yerine farklı olması gereken bir kurulumda olmanızdır.

DB_HOST alanına ne yazmalıyım#

Paylaşımlı hostingde neredeyse her zaman localhost yazılır, çünkü web sunucusu ve MySQL aynı makinededir. Veritabanı ayrı bir sunucuda barındırılıyorsa sağlayıcınızın verdiği sunucu adı veya IP adresi yazılır. Kendi bilgisayarınızdan uzaktan bağlanacaksanız localhost işe yaramaz; sunucunun IP adresini yazmanız ve cPanel'in Uzak MySQL ekranından kendi IP adresinizi izin listesine eklemeniz gerekir. localhost çalışmıyorsa 127.0.0.1 denemeye değer bir alternatiftir.

Site taşırken hangi veritabanı bilgilerini not almalıyım#

Dört temel bilgiye ek olarak tablo önekini de not alın; WordPress'te wp-config.php içindeki $table_prefix satırıdır ve genelde wp_ olur ama güvenlik için değiştirilmiş olabilir. Yeni sunucuda veritabanını içe aktardıktan sonra yeni yapılandırma dosyasında bu öneki aynı yazmazsanız WordPress tabloları bulamaz ve sizi kurulum ekranına yönlendirir. Ayrıca veritabanı boyutunu da kontrol edin; büyük dosyalarda phpMyAdmin'in yükleme sınırına takılabilirsiniz.

Test için oluşturduğum PHP dosyasını silmezsem ne olur#

İçinde açık veritabanı şifresi bulunan bir dosya web kök dizininde kalırsa, adresini bilen veya tahmin eden herkes tarayıcıdan açıp içeriği görebilir; PHP dosyası çalıştığı için ekranda kod görünmez ama kodda hata olursa şifre hata mesajıyla birlikte ekrana düşebilir. Daha kötüsü, aynı dosyayı .txt veya .bak uzantısıyla bıraktıysanız içeriği doğrudan düz metin olarak okunur. Test biter bitmez silin, yedek almanız gerekiyorsa web kök dizininin dışına taşıyın.

Veritabanı bilgilerini değiştirdim ama site hâlâ eski hatayı veriyor#

Büyük ihtimalle bir önbellek katmanı devrede. Sunucu tarafında OPcache açıksa PHP dosyasının eski hâli bellekte tutuluyor olabilir; cPanel'de PHP sürümünü tek tık değiştirip geri almak ya da bir dakika beklemek önbelleği temizler. Tarayıcı tarafında ise gizli sekmede deneyin. Üçüncü ihtimal, düzenlediğiniz dosyanın gerçekten sitenin kullandığı dosya olmamasıdır — özellikle OpenCart gibi iki ayrı yapılandırma dosyası olan sistemlerde ve alt dizinde ikinci bir kurulum varsa bu sık yaşanır.

Kapanış#

Veritabanı bağlantısı dört bilgiye indirgenir: ad, kullanıcı, şifre ve sunucu. Bu dördünün nerede yazdığını bilmek işin kolay kısmıdır — asıl mesele, hata aldığınızda hangisinin yanlış olduğunu ayırt etmektir. Şifre okunamaz, sadece sıfırlanır. Kullanıcı ile veritabanı iki ayrı nesnedir ve aralarındaki yetki bağı ayrıca kurulur. Önek her zaman hesap adıdır. Host paylaşımlı hostingde localhost, uzaktan bağlantıda IP'dir. Aldığınız hata mesajını yukarıdaki tabloyla eşleştirdiğinizde teşhis genellikle ilk denemede çıkar ve iş, saatlerce deneme yanılma yapmaktan birkaç dakikalık kontrole döner.

Bu tür işlemleri panelden rahatça yapabileceğiniz, veritabanı oluşturma, kullanıcı atama ve phpMyAdmin erişiminin hazır geldiği bir ortam arıyorsanız web hosting ve WordPress hosting paketleri cPanel ile birlikte gelir. Siteyi başka bir sağlayıcıdan taşırken veritabanı aktarımını hiç uğraşmadan halletmek isterseniz site taşıma hizmeti bu adımı üstlenir; kendi sunucunuzda MySQL yönetimi, yedekleme ve performans ayarlarını devretmek isterseniz sunucu yönetimi tarafına bakabilirsiniz.