WordPress sitenizdeki 413 Request Entity Too Large Hatası neden çıkar ve nasıl çözülür? Apache ve Nginx için adım adım konfigürasyon yöntemleri bu içerikte.
Dosya yüklemek için Medya Yükle butonuna tıkladınız, bekliyorsunuz ve karşınıza beklenmedik bir hata çıktı: 413 Request Entity Too Large Hatası. Ne sunucu tarafında bir arıza var ne de dosyanız bozuk. Sorun çok daha basit bir yerde gizli ve tam olarak bilmediğiniz için sizi çıkmaza sokuyor.
Bu hata, özellikle ağır tema görselleri, yedek dosyaları veya video içerikli medya yüklemelerinde sıkça karşılaşılan bir durumdur. WordPress’in kendisinden kaynaklanmıyor olması kafa karıştırıcı hissettirse de aslında çözüm son derece sistematik bir yol izliyor. Doğru adımları takip ettiğinizde, bu hatadan kalıcı olarak kurtulmak mümkün.
WordPress kurulumlarında karşılaşılan hatalar bazen çok katmanlı bir yapıya sahip olabiliyor. 413 Request Entity Too Large Hatası gibi sunucu kaynaklı sorunları çözmeden önce, sitenizin temel davranışını etkileyen başka konfigürasyon sorunlarını da göz önünde bulundurmanız faydalı olacaktır. Eğer yakın zamanda WordPress Çerezler Engellendi Hatası ile de karşılaştıysanız, bu iki sorun birbirinden bağımsız görünse de her ikisi de sunucu ile tarayıcı arasındaki iletişim zincirindeki kırılma noktalarını işaret ediyor olabilir. O nedenle, bu hatayı çözdükten sonra genel site sağlığınızı da bir kez gözden geçirmenizi öneririz.
413 Request Entity Too Large Hatası Nedir?
413 Request Entity Too Large Hatası, bir istemcinin (tarayıcı veya uygulama) sunucuya gönderdiği isteğin, sunucunun işlemeye razı olduğu boyutu aşması durumunda ortaya çıkar. Sunucu bu isteği reddeder, hatta bazı durumlarda bağlantıyı tamamen keser. Hatanın yeni resmi adı 413 Payload Too Large olsa da eski kullanım hâlâ yaygındır. Çözüm tek noktaya odaklanır: maksimum dosya boyutu sınırını yükseltmek.
413 Request Entity Too Large Hatası Nedenleri Nelerdir?
Bu hatanın birden fazla kaynağı olabilir ve hepsinin ortak paydası sunucu konfigürasyonudur.
Upload boyutu sınırı: PHP yapılandırmasındaki upload_max_filesize değeri, yüklemek istediğiniz dosyanın boyutunun altındaysa bu hata doğrudan tetiklenir.
Post boyutu sınırı: post_max_size değeri de kritik bir parametredir. Dosya boyutundan bağımsız olarak, POST isteğinin toplam boyutu bu değeri aşarsa yine aynı hatayla karşılaşırsınız.
Nginx client_max_body_size sınırı: Nginx tabanlı bir sunucuda çalışıyorsanız, client_max_body_size direktifi varsayılan olarak genellikle 1MB ile ayarlıdır. Bu değer değiştirilmeden diğer PHP ayarlarını düzenlemeniz sonuç vermez.
İzin hataları: Kullanıcı izinleri de süreci bloke edebilir. Yalnızca belirli bir kullanıcı hesabında bu hata yaşanıyorsa, sorun konfigürasyondan değil kullanıcı yetkilerinden kaynaklanıyor olabilir.
Sık yapılan bir hata şudur: Geliştiriciler yalnızca WordPress tarafındaki ayarları düzenleyip sunucu tarafını ihmal eder. Oysa bu hata büyük ölçüde sunucu katmanında kök salmaktadır.
Hatayı Çözmeye Başlamadan Önce Yapmanız Gerekenler
Doğrudan konfigürasyon dosyalarına müdahale etmeden önce iki ön kontrol yapın.
İlk olarak, dosyayı SFTP üzerinden doğrudan sunucuya yükleyin. wp-content/uploads klasörüne bağlanarak dosyayı buraya atın. Eğer bu yöntemle yükleme başarılı olursa, sorun WordPress arayüzünden kaynaklanıyor demektir ve sitenizin geliştiricisiyle iletişime geçmeniz gerekir.
İkinci adım olarak, kullanıcı izinlerini kontrol edin. WordPress dosya izinlerini gözden geçirin ve SFTP kullanıcınızı silip yeniden oluşturmayı deneyin. Bu basit adım, birçok konfigürasyon sorununu kökünden çözebilir.
413 Request Entity Too Large Hatası Çözüm Yöntemleri
1. functions.php Dosyasını Düzenleyin
SFTP istemcinizi açın ve hosting kontrol panelinizden bağlantı bilgilerinizi alın. Sunucunuzun kök dizinine gidin; bu klasör çoğunlukla www, public_html veya sitenizin kısaltılmış adıyla anılır. Burada functions.php dosyasını bulun veya yoksa bir metin editörüyle oluşturun.
Dosyaya şu satırları ekleyin:
@ini_set( 'upload_max_size' , '64M' );
@ini_set( 'post_max_size', '64M');
@ini_set( 'max_execution_time', '300' );64MB değeri büyük çoğunluk için yeterlidir; ancak video veya yedek gibi ağır dosyalar için bu değeri daha yükseğe çekebilirsiniz. Dosyayı kaydedin ve sunucuya yeniden yükleyin.
2. .htaccess Dosyasını Güncelleyin
Apache tabanlı bir sunucu kullanıyorsanız .htaccess dosyası sizin için doğrudan konfigürasyon kapısıdır. Nginx kullanan sağlayıcılarda bu dosya bulunmaz.
Kök dizinde .htaccess dosyasını açın. # END WordPress satırının hemen altına şunları ekleyin:
php_value upload_max_filesize 64M
php_value post_max_size 64M
php_value max_execution_time 300
php_value max_input_time 300Değişikliği kaydedin, dosyayı sunucuya geri yükleyin ve hatanın devam edip etmediğini kontrol edin.
Nginx Sunucusunda Ne Yapmalısınız?
Nginx üzerinde çalışıyorsanız .htaccess yerine nginx.conf dosyasına müdahale etmeniz gerekir. Bu dosyaya client_max_body_size 64M; direktifini eklemeniz yeterlidir. Ancak bununla birlikte php.ini dosyasındaki ilgili değerleri de güncellemeniz şarttır; yalnızca Nginx tarafını değiştirmek sorunu çözmez.
Bu noktada uyarı niteliğinde bir not düşmek gerekiyor: Nginx konfigürasyonu, hatalı bir düzenlemeyle sitenizi tamamen erişilemez hale getirebilir. Eğer bu adımda kendinizi güvende hissetmiyorsanız ya da hosting sağlayıcınız sunucu dosyalarına doğrudan erişim konusunda kısıtlama getiriyorsa, profesyonel destek almanız en sağlıklı yol olacaktır. 2011 yılından bu yana Türkiye genelinde milyonlarca kullanıcıya 7/24 teknik destek sunan 11858 Teknoloji Destek Hattı, bu tür sunucu konfigürasyon sorunlarında da devreye girebiliyor. TeamViewer ve AnyDesk gibi lisanslı yazılımlar üzerinden uzaktan bağlantı desteğiyle çalışan ekip, dakika bazlı şeffaf ücretlendirme sistemi ve yüzde 95 memnuniyet oranıyla 500.000’den fazla başarılı işlem gerçekleştirmiş durumda.
WordPress’te dosya boyutu sınırlarını aşmak, beraberinde sitenizin genel yapılandırmasında bazı değişikliklere kapı aralıyor. Bu noktada WordPress’te Düzenleme Yapma konusunu da incelemenizi öneririz; özellikle tema dosyalarına ve yapılandırma dosyalarına el attığınızda nelere dikkat etmeniz gerektiğini öğrenmek, hem bu hatanın hem de olası başka sorunların önüne geçmenizi sağlayacaktır.
413 Request Entity Too Large Hatası ilk bakışta soyut ve çözülmesi güç bir hata izlenimi verse de kök nedeni bellidir: sunucu, sizden daha büyük düşünmüyor. Sorunu kalıcı olarak ortadan kaldırmak için sunucu tipinizi (Apache mi, Nginx mi?) doğru tespit etmek ve ardından doğru konfigürasyon dosyasını düzenlemek gerekiyor. Yalnızca WordPress tarafında değişiklik yapıp sunucu katmanını atlayanların büyük çoğunluğu, hatanın tekrar ettiğini görecektir. Eğer siz de bu hatayla karşılaştınız ve hangi yöntemin işe yaradığını ya da yaramadığını deneyimlediyseniz, aşağıya bir yorum bırakın; başkalarının aynı sorunu çözmesine katkı sağlamış olursunuz.
