WordPress Dosya Türü Yükleme Hatası Nasıl Çözülür

Son gözden geçirme: Eylül 2026 · WordPress 6.8 resmî dokümanına göre

WordPress dosya türü yükleme hatası neden olur

WordPress her yüklemede iki kontrol yapar. İlki uzantıya bakar: get_allowed_mime_types() fonksiyonu izin verilen uzantı ve MIME türü listesini döndürür, listede olmayan uzantı doğrudan reddedilir. İkincisi dosyanın içeriğini okur ve gerçek türü uzantının beklediği türle karşılaştırır. Adı logo.png olan ama içi başka biçimde kaydedilmiş bir dosya bu ikinci kontrolde takılır.

Varsayılan liste JPEG, PNG, GIF, WebP, AVIF, HEIC gibi görselleri, PDF ve Office belgelerini, yaygın ses ve video biçimlerini ve ZIP arşivini kapsar. SVG, JSON, WOFF2 ve TTF listede yoktur. EXE her zaman çıkarılır; HTML ve JS ise yalnız unfiltered_html yetkisi olan kullanıcılara açıktır. Bu yüzden aynı dosyayı yönetici yükleyebilirken yazar rolündeki kullanıcı aynı hatayı görebilir.

Adım adım çözüm

1. Dosya adını ve uzantısını kontrol edin. Windows varsayılan olarak bilinen uzantıları gizler; rapor.pdf.exe ya da resim.jpg.webp gibi çift uzantılı dosyalar masaüstünde normal görünür. Dosya Gezgini’nde Görünüm menüsünden dosya adı uzantılarını açıp adı düzeltin.

   Beklenen sonuç: dosya adı tek ve doğru uzantıyla biter.

2. Türün izin listesinde olup olmadığına bakın. Uzantı yukarıdaki varsayılan listede yoksa hata beklenen davranıştır; güncel liste WordPress geliştirici dokümanında yer alır. Uzantı listede olduğu hâlde hata çıkıyorsa dosya içeriği uzantısıyla uyuşmuyordur; dosyayı kaynağında doğru biçimle yeniden dışa aktarın.
   

   

   Beklenen sonuç: dosyanın listede olup olmadığını ve hangi durumda olduğunuzu biliyorsunuz.

3. Desteklenen biçime çevirin (önerilen). Logo ve ikon için SVG yerine PNG ya da WebP kullanın; yazı tipini Medya’ya değil tema ya da eklenti dosyalarına koyun. Büyük dosyada boyut sınırına takılıyorsanız sorun tür değil, sınırdır: WordPress yükleme boyutu artırma kartına bakın.

   Beklenen sonuç: dönüştürülen dosya Medya → Yeni ekle ekranından hatasız yüklenir.

4. Gerekirse tek bir türü filtreyle ekleyin. Alt temanın functions.php dosyasına ya da bir kod parçacığı eklentisine aşağıdaki satırları ekleyin; yöntemler WordPress siteye kod ekleme kartında anlatılıyor. Filtre upload_mimes adını taşır.

   add_filter( 'upload_mimes', function ( $mimes ) {
       $mimes['json'] = 'application/json';
       return $mimes;
   } );

   Beklenen sonuç: eklenen uzantı yüklenir. İçerik kontrolü sürdüğü için sunucunun dosyayı farklı bir türde tanıdığı durumda hata devam edebilir; o zaman MIME değerini dosyanın gerçek türüne göre yazın.

5. SVG için temizleyen bir eklenti kullanın. SVG bir resim değil, XML metnidir ve içine JavaScript gömülebilir; filtreyle doğrudan açılan SVG, siteye yükleme yapabilen herkese kod çalıştırma yolu verir. SVG’yi yükleme sırasında temizleyen bir eklenti seçin ve yüklemeyi yalnız yöneticilere bırakın.

   Dikkat

   wp-config.php içine define( 'ALLOW_UNFILTERED_UPLOADS', true ); yazmak yöneticiler için tür kontrolünü tamamen kapatır. Ele geçirilmiş tek bir yönetici hesabı sunucuya PHP dosyası bırakabilir. Bu ayar kalıcı çözüm değildir; açtıysanız işiniz biter bitmez satırı silin.

Doğrulama

Hâlâ çözülmediyse

• Hata yalnız görsellerde, rastgele çıkıyor. Klasör izni ya da yükleme dizini sorunu olabilir; WordPress resimler neden yüklenmez kartındaki kontrolleri yapın.
• Filtre ekledim ama hata sürüyor. Kod çalışmıyor ya da içerik kontrolü dosyayı reddediyor; kodun etkin temada ya da eklentide olduğunu doğrulayın, dosyayı yeniden dışa aktarın.
• wp-config.php içinde hangi sabitlerin olduğunu bilmiyorum. Dosyanın düzeni ve güvenli sabitler için wp-config.php ayarları kartına bakın.