wp-config.php Dosyası Nerede ve Nasıl Düzenlenir?

Bir kullanıcımızdan şöyle bir soru aldık: “WordPress sitemde bazı ayarları değiştirmem gerektiğinde sürekli ‘wp-config.php dosyasını düzenleyin’ gibi tavsiyeler görüyorum. Ama bu dosyanın tam olarak nerede olduğunu, hangi klasör içinde yer aldığını ve ona nasıl güvenli bir şekilde ulaşabileceğimi tam bilmiyorum. FTP ya da cPanel üzerinden mi açmam gerekiyor, yoksa WordPress admin panelinden de erişme imkânım var mı? Bir de bu dosyayı bulduktan sonra üzerinde değişiklik yaparken nelere dikkat etmeliyim?” Bu sorunun yanıtını detaylı olarak aşağıda açıkladık…

WordPress sitenizin en kritik dosyalarından biri olan wp-config.php, sitenizin veritabanı bağlantısından güvenlik ayarlarına kadar pek çok önemli bilgiyi barındırır. Bu dosya olmadan WordPress, veritabanına erişemez ve siteniz çalışma. İçindeki her satır, sitenizin nasıl davranacağını belirler. Örneğin, veritabanı bağlantısı kurulamazsa “Veritabanı Bağlantı Hatası” gibi uyarılar alırsınız. WordPress sürümlerinde bu dosya otomatik olarak oluşturulur, ancak manuel düzenlemeler için erişmeniz gerekebilir. Diyelim ki siteniz yavaş çalışıyor. wp-config.php’ye girip bir kod satırı ekleyerek bellek limitini artırıp sorunu çözebilirsiniz.

Dosyanın içeriği PHP programlama dilinde yazılmıştır ve WordPress’in çalışması için gerekli sabit değerleri (constants) tanımlar. Örneğin, DB_NAME, DB_USER, DB_PASSWORD gibi sabitler, sitenizin hangi veritabanını kullanacağını belirtir. Ayrıca WP_DEBUG gibi geliştirici ayarları da burada yapılandırılır.

wp-config.php Dosyası Nerede Bulunur?

wp-config.php dosyasının konumunu bilmek, düzenleme işleminin ilk adımıdır. Bu dosya genelde sitenin ana dizininde yani public_html ya da domain adının kök klasöründe bulunur. Ancak hosting türünüze ve kurulum şeklinize göre konum değişiklik gösterebilir.

• Standart Konum– Dosya, public_html, www veya httpdocs klasörünün içinde, wp-content, wp-admin ve wp-includes klasörleriyle aynı seviyededir.
• Alternatif Konum (Güvenlik İçin)– Bazı kullanıcılar güvenlik amacıyla wp-config.php dosyasını bir üst dizine taşır. WordPress otomatik olarak bir üst dizini kontrol eder ve dosyayı orada bulursa kullanır.
• Alt Dizin Kurulumları– WordPress’i bir alt klasöre kurduysenız (örneğin public_html/blog), wp-config.php dosyası o alt klasörün içinde olacaktır.
• Çoklu Site (Multisite) Kurulumları– WordPress Multisite kullanıyorsanız, tüm siteler için tek bir wp-config.php dosyası ana kurulum dizininde bulunur ve ek yapılandırmalar içerir.

📌 Dosyayı bulamıyorsanız, FTP/SFTP istemcinizde “gizli dosyaları göster” seçeneğini etkinleştirin. Bazı sunucularda nokta (.) ile başlayan veya özel izinlere sahip dosyalar varsayılan olarak gizlidir.

wp-config.php Erişim ve Düzenleme

wp-config.php dosyasını düzenlemek için birkaç farklı yöntem kullanabilirsiniz. Her yöntemin avantajları ve kullanım senaryoları vardır. İşte en yaygın erişim yöntemleri:

1. cPanel ile wp-config.php’ye Erişme ve Düzenleme

Çoğu hosting sağlayıcı, cPanel üzerinden erişilebilen bir dosya yöneticisi sunar. Bu yöntem hızlı ve kullanıcı dostudur.

• Önce mutlaka tam site yedeği alın (bkz: WordPress Yedek Alma Yöntemleri).
• cPanel’e giriş yapın ve ardından Dosya Yöneticisi‘ne tıklayın.
• Sol menüden “public_html” veya sitenizin kök klasörünü seçin.
• Klasörler arasında gezinin: wp-admin, wp-content, wp-includes gibi klasörleri göreceksiniz.
• Hemen altlarında wp-config.php dosyasını bulacaksınız.
• Eğer bulamıyorsanız, dosya yöneticisinde arama çubuğuna “wp-config.php” yazın. Bulunduğu konum genellikle /home/kullanıcıadı/public_html/wp-config.php şeklindedir.
• wp-config.php dosyasını açmadan önce bir kopyasını bilgisayarınıza indirin (her ihtimale karşı 2 ayrı kopya indirin. Birini düzenlemek için kullanın diğeri orijinal ayarlarıyla kalsın. Düzenlenen dosyayı yüklediğinizde bir sorun çıkarsa eski kopyayı yükleyebilirsiniz).
• Dosyayı sadece metin editörü (Notepad++, VS Code) ile düzenleyin; Word veya benzeri programlar kullanmayın.
• Satır sonlarına noktalı virgül, tırnak işaretleri ve parantezlere özellikle dikkat edin; küçük bir hata sitenizi bozabilir.
• Yeni kod ekleyecekseniz, genelde /* That’s all, stop editing! Happy blogging. */ satırının üstüne yazmanız önerilir.
• İşiniz bittiğinde dosyayı kaydedip kök dizine geri yükleyin.

2. FTP/SFTP İle Erişim ve Düzenleme

FileZilla, Cyberduck veya WinSCP gibi FTP programları kullanarak sunucunuza bağlanabilirsiniz. Bu yöntem, özellikle büyük dosyalarla çalışırken veya toplu işlemler yaparken tercih edilir.

• Hosting hesabınızdan FTP bilgilerinizi alın (kullanıcı adı, şifre, sunucu adresi).
• FTP istemcisini açın ve bağlanın.
• Kök dizine gidin (genellikle /public_html/).
• wp-config.php’yi doğrudan göreceksiniz – sağ tıklayıp indirin veya düzenleyin.
• Eğer dosya görünmüyorsa, kök dizinde sağ üstte bulunan Ayarlar’a tıklayın ve gizli dosyaları göster seçeneğini etkinleştirin. Bazı hostinglerde wp-config.php bir seviye yukarıda olabilir, örneğin /var/www/html/ altında. Sorun yaşamaya devam ederseniz hosting firmanızdan destek alın.

3. Diğer Hosting Panelleri (Plesk, DirectAdmin vb.)

• Plesk’te “Dosyalar” sekmesine gidin, DirectAdmin’de “File Manager“ı kullanın. Kök dizin her zaman aynı: Sitenizin ana klasörü. Bulamıyorsanız, hosting destek ekibine sorun, onlar size tam yolu verebilir.
• Eğer bulamıyorsanız ne yapmalısınız? Öncelikle, WordPress’in kurulu olup olmadığını kontrol edin. Eğer yeni bir kurulumsa, wp-config-sample.php adında bir örnek dosya olabilir; bunu kopyalayıp wp-config.php olarak kaydedin. Veya sitenizde “Error Establishing a Database Connection” hatası varsa, dosya hasar görmüş olabilir, yeniden oluşturun.

📌 Ayrıca, gelişmiş kullanıcılar SSH üzerinden terminal komutlarıyla dosyayı düzenleyebilirler. nano, vim veya vi gibi editörler kullanılır. Örnek: nano wp-config.php. Ayrıca bazı yerel geliştirme araçlarında farklı klasör yapıları bulunur; Örneğin Local by Flywheel, XAMPP, WAMP gibi araçlarda dosya app/public/ veya htdocs/ içinde olur.

wp-config.php’yi düzenlerken dikkat etmeniz gerekenler:

• Hangi yöntemi seçerseniz seçin, mutlaka orijinal dosyanın yedeğini alın. Bir hata durumunda geri dönüş yapabilmek için bu kritik önem taşır. Dosyayı düzenlerken metin editörü kullanın (Notepad++, Sublime Text, VS Code gibi) ve kesinlikle Microsoft Word gibi kelime işlemci programları kullanmayın.
• Dosya izinlerini düzenleyin. wp-config.php için önerilen izinler genelde 600 veya 640’tır. Sunucu ortamına bağlı olarak 440 veya 400 da kullanılabilir. (bkz: WordPress Dosya İzinleri Nasıl Değiştirilir?)
• wp-config.php içindeki DB kullanıcı adı/parolası, security keys vb. kimseyle paylaşılmayın.
• WordPress admin içinden dosya düzenlemeyi kapatın: (bkz: WordPress Dosya Düzenleme Nasıl Devre Dışı Bırakılır?)