WordPress .htaccess dosyası

Mehmet · 28 dakika önce

WordPress’te .htaccess dosyası, Apache web sunucusunun site klasöründeki kuralları uygulamasını sağlar. En önemli görevi, kalıcı bağlantıların çalışması için gelen istekleri index.php dosyasına yönlendirmektir. Dosya genellikle WordPress’in ana dizininde bulunur ve nokta ile başladığı için FTP istemcilerinde gizli görünebilir.

Bu dosya yalnızca Apache veya Apache uyumlu yapılandırmayı destekleyen sunucularda kullanılır. İsteği yalnız Nginx işliyorsa bu kurallar doğrudan .htaccess dosyasıyla uygulanmaz. Nginx’in arkasında Apache de bulunuyorsa dosyanın etkisi isteğin Apache’ye ulaşıp ulaşmadığına bağlıdır.

.htaccess dosyası nasıl çalışır?

WordPress’te Ayarlar → Kalıcı bağlantılar ekranından “Yazı ismi” gibi bir yapı seçildiğinde, WordPress Apache’nin mod_rewrite modülünü kullanarak kurallar oluşturur. Var olan gerçek bir dosya veya klasör bulunamazsa istek index.php dosyasına gönderilir. WordPress de URL’ye göre hangi yazı, sayfa veya arşivin gösterileceğine karar verir.

Örneğin https://example.com/ornek-sayfa/ adresinde sunucuda gerçekten ornek-sayfa adlı bir klasör bulunmayabilir. .htaccess isteği WordPress’e aktarır ve ilgili sayfa görüntülenir.

Aşağıdaki örnek, alan adı kökünde çalışan temel tek-site kurulumunun mantığını gösterir. Alt dizin kurulumu ve Multisite için aynen kopyalanmamalıdır; sitenizin ürettiği kuralları kullanın:

Kod:

# BEGIN WordPress
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>
# END WordPress

Bu alanı mümkünse elle değiştirmeyin. WordPress, kalıcı bağlantılar ekranında kaydetme işlemi yapıldığında # BEGIN WordPress ile # END WordPress arasındaki bölümü yeniden yazabilir.

Dosyayı kontrol etme ve yeniden oluşturma

Kalıcı bağlantılar 404 hatası veriyorsa veya WordPress .htaccess dosyasının yazılabilir olmadığını bildiriyorsa şu sırayı izleyin:

FTP, hosting dosya yöneticisi veya SSH üzerinden WordPress’in index.php dosyasının bulunduğu ana dizini açın.
Gizli dosyaların gösterilmesini etkinleştirin ve .htaccess dosyasını bulun.
Değişiklikten önce dosyanın bir kopyasını bilgisayarınıza veya webden erişilmeyen bir yedek konumuna alın.
Sunucu hata günlüğünü inceleyip sorunlu kuralı belirleyin. Dosyanın tamamını devreden çıkarmak yerine yalnız ilgili değişikliği geri alın; özel erişim kurallarını koruyun.
WordPress yönetiminde Ayarlar → Kalıcı bağlantılar ekranını açın ve mevcut yapıyı değiştirmeden “Değişiklikleri kaydet” düğmesine basın.
Oluşan yazı, sayfa ve arşiv bağlantılarını kontrol edin. Sorun devam ederse hosting sağlayıcısından Apache mod_rewrite desteğini, ilgili dizinde gerekli AllowOverride iznini ve dosya sahipliğini incelemesini isteyin.

WordPress dosyayı otomatik yazamıyorsa aynı ekranda gerekli kuralları metin olarak gösterebilir. Bu kuralları kopyalayıp, yedeği alınmış .htaccess dosyasına ekleyin. Dosyanın adı yanlışlıkla .htaccess.txt olmamalıdır.

Hangi durumda ne yapılmalı?

Belirti	Olası neden	Uygulanacak işlem
Yazı adresleri 404 veriyor	Kalıcı bağlantı kuralları yok veya mod_rewrite kapalı	Kalıcı bağlantıları yeniden kaydedin; sunucuyu kontrol ettirin
Tüm site 500 hatası veriyor	Hatalı sözdizimi veya uyumsuz kural	Dosyayı yedekten geri alın ve kuralları tek tek ekleyin
WordPress dosyayı yazamıyor	Dosya yok, izinler uygun değil veya sahiplik sorunu var	Dosyayı doğru dizinde oluşturun ve hosting desteği alın
Değişiklikler kayboluyor	Eklenti veya WordPress kendi bölümünü yeniden yazıyor	Özel kuralları WordPress bloğunun dışına taşıyın

Özel yönlendirme, erişim engelleme veya önbellek kuralları ekleyecekseniz, bunları WordPress tarafından yönetilen bloğun dışına yazın. Her değişiklikten sonra ana sayfa, bir yazı, bir sayfa ve yönetim girişini ayrı ayrı test edin.

Sık yapılan hatalar

Yedeği almadan düzenlemek: Tek bir sözdizimi hatası sitenin 500 hatası vermesine neden olabilir. Sorun yaşarsanız yedek dosyayı geri yüklemek en hızlı geri dönüş yoludur.

Sunucu türünü doğrulamamak: Dosyanın bulunması, Nginx’in bu dosyayı okuyacağı anlamına gelmez. Sunucu yazılımını hosting panelinden veya sağlayıcınızdan doğrulayın.

WordPress bloğunun içine özel kural eklemek: Kalıcı bağlantılar yeniden kaydedildiğinde bu kurallar silinebilir. Özel kuralları # BEGIN WordPress satırından önce veya # END WordPress satırından sonra tutun.

Dosya adını yanlış kaydetmek: Başındaki nokta, uzantı ve küçük harf kullanımı önemlidir. Doğru ad .htaccess şeklindedir.

Sık sorulan sorular

.htaccess dosyasını silmek siteyi tamamen bozar mı?

Her zaman tamamen bozmaz; ancak özel yönlendirmeler, güvenlik kuralları ve kalıcı bağlantılar çalışmayabilir. Önce erişilmeyen konumda yedek alın. Sorun yalnız WordPress bağlantı kurallarıysa o bölümü yeniden üretin; özel güvenlik ve yönlendirme kurallarını kaybetmeyin.

.htaccess dosyası neden FTP’de görünmüyor?

Nokta ile başlayan dosyalar gizli kabul edilir. FTP istemcisinde “gizli dosyaları göster” seçeneğini etkinleştirin veya hosting dosya yöneticisini kullanın.