413 Request Entity Too Large Hatası Nedir? Nasıl Çözülür?

413 Request Entity Too Large, gönderilen isteğin gövdesinin sunucunun kabul ettiği boyut sınırını aştığını bildiren HTTP durum kodudur. Sunucu isteği almış, gövde boyutunu okumuş ve tanımlı sınırla karşılaştırmıştır; sınır aşıldığı için isteği işlemeden reddeder. Güncel HTTP standardında kodun adı 413 Content Too Large olarak güncellenmiştir ve iki isim aynı durumu tanımlar.

Bu rehberde 413 hatasının anlamını, hangi durumlarda görüldüğünü ve boyut sınırı koyan katmanları açıklıyoruz. Ardından Nginx, Apache, PHP, IIS ve .NET tarafındaki ayarları, WordPress ile Laravel uygulamalarındaki çözümü ve kontrol panelleri üzerinden yapılan değişikliği ele alıyoruz. Son bölümlerde yükleme sınırının ne kadar artırılması gerektiğini ve barındırma türünün bu sınıra etkisini anlatıyoruz.

413 Request Entity Too Large Ne Demek?

413 Request Entity Too Large, gönderilen isteğin gövdesinin sunucunun kabul ettiği boyut sınırını aştığını bildiren HTTP durum kodudur. Kodun Türkçe karşılığı “istek gövdesi çok büyük” biçimindedir. Güncel HTTP standardında kod 413 Content Too Large adıyla tanımlanır; sunucu yazılımları her iki ismi de kullanır. Hata tarayıcıda “413 Request Entity Too Large”, “Payload Too Large” veya sunucu adıyla birlikte “413 Request Entity Too Large nginx” biçiminde görüntülenir.

413 Hatası Hangi Durumlarda Görülür?

413 hatası aşağıdaki durumlarda görülür:

• Büyük dosya yüklemede. Video, arşiv ve yüksek çözünürlüklü görsel yüklemeleri 50 MB ile 500 MB arasında değişir.
• Toplu içe aktarmada. Ürün ve müşteri listesi aktarımlarında kullanılan dosyalar 10 MB ile 100 MB arasında yer alır.
• Yedek geri yüklemede. Site yedekleri 200 MB ile birkaç gigabayt arasında değişir.
• Çoklu görsel yüklemede. Tek istekte gönderilen görsel grubu toplamda 20 MB sınırını aşar.
• Büyük form gönderiminde. Uzun metin alanları ve eklerle birlikte form gövdesi 8 MB değerini geçer.

413 Hatasında Hangi Katmanlar Sınır Koyar?

Bir yükleme isteği sunucuya ulaşana kadar birden fazla katmandan geçer ve her katman kendi boyut sınırını uygular. Katmanlar, direktifleri ve varsayılan değerleri aşağıdaki tabloda verilmiştir.

Katmanlardan biri düşük kaldığında hata devam eder. En sık yapılan hata yalnızca Nginx değerinin yükseltilmesidir; PHP tarafındaki upload_max_filesize 2 MB değerinde bırakıldığında yükleme yine reddedilir. Değişiklik yapılırken tüm katmanlar birlikte gözden geçirilir.

Nginx’te 413 Hatası Nasıl Çözülür?

Nginx tarafındaki 413 hatası client_max_body_size direktifinin yükseltilmesiyle çözülür. Çözüm adımları aşağıda sıralanmıştır:

1. Yapılandırma dosyasını açın: /etc/nginx/nginx.conf
2. Direktifi http bloğuna ekleyin: client_max_body_size 64M;
3. Yapılandırmayı sınayın: nginx -t
4. Yeniden yükleyin: systemctl reload nginx

Direktifin yerleştirildiği blok kapsamı belirler. http bloğunda tanımlandığında tüm siteler için geçerli olur, server bloğunda tek siteye, location bloğunda ise yalnızca belirli bir adrese uygulanır. Yalnızca yönetim paneli için sınır yükseltmek amacıyla aşağıdaki tanım kullanılır:

location /wp-admin/ {
    client_max_body_size 128M;
}

Sunucu yazılımının blok hiyerarşisi ve direktif kapsamı Nginx rehberinde açıklanmıştır.

Apache Sunucularda İstek Boyutu Sınırı Nasıl Artırılır?

Apache tarafındaki sınır LimitRequestBody direktifiyle tanımlanır ve değer bayt cinsinden yazılır. 64 MB için kullanılan tanım aşağıdadır:

LimitRequestBody 67108864

Direktif sanal sunucu yapılandırmasında ya da dizin bazında .htaccess dosyasında tanımlanır. Sanal sunucu yapılandırmasındaki değer tüm site için geçerlidir; .htaccess dosyasındaki değer yalnızca bulunduğu dizin ve alt dizinlerini kapsar. Değerin 0 olarak bırakılması sınırı kaldırır ve sunucuyu büyük istek saldırılarına açık hale getirir.

PHP Tarafında Yükleme Sınırı Nasıl Artırılır?

PHP tarafındaki yükleme sınırı dört değerin birlikte yükseltilmesiyle artırılır. php.ini dosyasında yapılan tanım aşağıdadır:

upload_max_filesize = 64M
post_max_size = 128M
memory_limit = 256M
max_input_time = 300

Değerler arasında sabit bir hiyerarşi vardır ve bu sıra bozulduğunda ayar etkisiz kalır:

• post_max_size değeri upload_max_filesize değerinden büyük olmalıdır
• memory_limit değeri post_max_size değerinden büyük olmalıdır
• max_input_time değeri büyük dosyaların aktarım süresini karşılamalıdır

Ayarların uygulandığı php -i | grep upload_max_filesize komutuyla ya da bir phpinfo() sayfası oluşturularak doğrulanır. PHP-FPM kullanılan sistemlerde değişiklik sonrası servis yeniden başlatılır. Sürüm yönetimi ve uzantı desteği PHP hosting rehberinde ele alınmıştır.

IIS ve ASP.NET Uygulamalarında 413 Hatası Nasıl Giderilir?

IIS sunucularda 413 hatası maxAllowedContentLength ve maxRequestLength değerlerinin birlikte yükseltilmesiyle giderilir. İki değer farklı birim kullanır ve bu ayrım sıkça gözden kaçar:

• maxAllowedContentLength değeri bayt cinsindendir
• maxRequestLength değeri kilobayt cinsindendir

64 MB sınırı için web.config dosyasına eklenen tanım aşağıdadır:

<configuration>
  <system.web>
    <httpRuntime maxRequestLength="65536" executionTimeout="300" />
  </system.web>
  <system.webServer>
    <security>
      <requestFiltering>
        <requestLimits maxAllowedContentLength="67108864" />
      </requestFiltering>
    </security>
  </system.webServer>
</configuration>

.NET Core uygulamalarında sınır denetleyici düzeyinde [RequestSizeLimit(67108864)] özniteliğiyle tanımlanır. Kestrel sunucusu kullanılıyorsa MaxRequestBodySize değeri de güncellenir.

WordPress ve Laravel Sitelerinde 413 Hatası Nasıl Düzeltilir?

WordPress ve Laravel uygulamalarındaki 413 hatası uygulama katmanında değil, altındaki sunucu ve PHP katmanlarında çözülür. İki uygulama için izlenen yollar aşağıda verilmiştir.

WordPress sitelerinde sınır üç noktadan yükseltilir. Birinci nokta .htaccess dosyasıdır:

php_value upload_max_filesize 64M
php_value post_max_size 128M
php_value memory_limit 256M

İkinci nokta wp-config.php dosyasıdır ve bellek sınırı buradan tanımlanır. Üçüncü nokta tema dosyasındaki filtre tanımıdır. Uygulanan değer yönetim panelindeki Medya bölümünde “Maksimum yükleme dosyası boyutu” satırında görüntülenir ve doğrulama buradan yapılır.

Laravel uygulamalarında sınır PHP ve web sunucusu katmanlarından yükseltilir. Uygulama içindeki doğrulama kuralları da güncellenir; max kuralı kilobayt cinsinden tanımlanır ve sunucu sınırından düşük kaldığında yükleme uygulama tarafından reddedilir. Eklenti kaynaklı yavaşlamalar ve kaynak tüketimi WordPress hızlandırma rehberinde ele alınmıştır.

cPanel ve Plesk Üzerinden Yükleme Sınırı Nasıl Değiştirilir?

Kontrol paneli kullanılan sunucularda yükleme sınırı arayüz üzerinden değiştirilir. İki panelde izlenecek adımlar aşağıda verilmiştir:

1. cPanel: Yazılım bölümündeki MultiPHP INI Editor açılır. Editor Mode sekmesi seçilir, alan adı belirlenir ve upload_max_filesize ile post_max_size değerleri güncellenir. Kaydet düğmesine basıldığında ayar hemen uygulanır.
2. Plesk: Alan adı seçilir, PHP Settings sayfası açılır. Performance settings bölümündeki memory_limit, post_max_size ve upload_max_filesize alanları güncellenir ve OK düğmesine basılır.

Paylaşımlı barındırma paketlerinde bu değerlerin bir üst sınırı bulunur ve sağlayıcı tarafından belirlenir. Üst sınırın üzerindeki değerler kaydedilse bile uygulanmaz. Panel araçları ve yetki sınırları cPanel hosting rehberinde anlatılmıştır.

Yükleme Sınırı Ne Kadar Artırılmalıdır?

Yükleme sınırı gerçek ihtiyacın iki katı olarak belirlenir ve sınırsız bırakılmaz. Kullanım türüne göre önerilen değerler aşağıda verilmiştir:

• Standart kurumsal site için 64 MB
• Görsel yoğun e-ticaret sitesi için 128 MB
• Video barındıran site için 256 MB
• Yedek geri yükleme işlemi için geçici olarak 512 MB

Sınırın kaldırılması sunucuyu iki riske açar. Birinci risk kaynak tüketimidir; büyük istekler bellek ve disk alanını hızla doldurur. İkinci risk saldırı yüzeyidir; sınırsız gövde kabul eden bir sunucuya art arda büyük istek gönderilerek hizmet durdurulabilir. Yedek geri yükleme gibi tek seferlik işlemler için sınır geçici olarak yükseltilir ve işlem bittiğinde eski değere döndürülür.

Barındırma Türü Yükleme Sınırını Nasıl Etkiler?

Barındırma türü, yükleme sınırını değiştirme yetkisini ve ulaşılabilecek üst değeri belirler. Karşılaştırma aşağıdaki tabloda verilmiştir.

Paylaşımlı barındırmada web sunucusu yapılandırması tüm hesaplar için ortaktır ve tek hesap için değiştirilmez. Büyük dosya yükleme ihtiyacı düzenli hale geldiğinde sanal sunucuya geçiş yapılır. Verimin olarak sunduğumuz sanal sunucularda tüm katman değerlerini projenize göre yapılandırıyoruz; kaynak ve yetki ihtiyacınız için sanal sunucu paketlerimizi inceleyebilirsiniz.

413 Hatası Ayar Değiştikten Sonra Devam Eder mi?

Evet, katmanlardan biri güncellenmediğinde 413 hatası ayar değişikliğine rağmen devam eder. En sık atlanan katman PHP tarafındaki post_max_size değeridir. İkinci sık atlanan adım servis yeniden başlatmadır; Nginx ve PHP-FPM yeniden yüklenmediğinde eski değerler bellekte kalır. Değişiklik sonrası systemctl reload nginx ve systemctl restart php-fpm komutları çalıştırılır.

413 Hatası Dosya Türüyle İlgili midir?

Hayır, 413 hatası dosya türünden bağımsızdır. Sunucu yalnızca gövde boyutunu denetler ve içeriğin türüne bakmaz. İzin verilmeyen bir dosya türü gönderildiğinde uygulama farklı bir hata üretir ve mesajda dosya türü belirtilir.

Büyük Dosyalar İçin Alternatif Yükleme Yolu Var mıdır?

Evet, büyük dosyalar tarayıcı yerine FTP veya SSH üzerinden yüklenir. Bu yöntemler HTTP katmanını atladığı için boyut sınırına takılmaz ve aktarım kesintiye uğradığında kaldığı yerden devam eder. Yedek geri yükleme ve medya kütüphanesi aktarımı gibi işlemler için tercih edilen yol budur. Aktarım protokolü ve istemci kullanımı FTP nedir rehberinde anlatılmıştır.

Sınır değişikliği sonrasında hata sürüyorsa teknik destek ekibimize başvurabilirsiniz. Yüklemeye çalıştığınız dosyanın boyutunu, hedef adresi ve panelde görünen mevcut sınır değerini iletmeniz inceleme süresini kısaltır.