WordPress
WordPress 413 Request Entity Too Large hatası nasıl çözülür?

Kısa yanıt
WordPress 413 Request Entity Too Large hatası, yüklediğiniz dosyanın (bir eklenti, tema paketi, medya dosyası veya içe aktarma dosyası) sunucunun tek bir istek için kabul ettiği üst sınırı aştığı anlamına gelir. Bu, WordPress’in kendi hatası değildir; istek WordPress koduna hiç ulaşmadan web sunucusu (Nginx veya Apache) ya da PHP seviyesinde.
Reddedilir.
Çözüm iki ana yoldan birine dayanır: dosyayı sunucuya PHP’nin yükleme sınırına takılmadan ulaştırmak (FTP ile) veya sunucudaki upload_max_filesize, post_max_size ve (Nginx kullanıyorsanız) client_max_body_size değerlerini kalıcı olarak artırmak. Hangi durumda hangisini seçmeniz gerektiği, dosyanın türüne ve panelinizin sunduğu erişime bağlıdır.
WordPress 413 Request Entity Too Large hatası neden çıkar?
Tarayıcıda gördüğünüz “413 Request Entity Too Large” mesajı, HTTP protokolünün standart bir hata koduna karşılık gelir; WordPress’e özgü bir hata değildir. Bu mesaj, isteğinizdeki veri miktarı (genellikle bir dosya) sunucunun veya PHP’nin tanımlı üst sınırını geçtiğinde tetiklenir. En sık görüldüğü anlar şunlardır:
- Yönetim panelinden büyük bir tema veya eklenti ZIP dosyası yüklerken
- Medya kitaplığına yüksek çözünürlüklü görsel, video veya ses dosyası eklerken
- Bir yedekleme veya içe aktarma eklentisiyle büyük bir
.sqlveya.xmldosyasını siteye aktarırken - WooCommerce gibi bir eklentide toplu ürün içe aktarma dosyası yüklerken
Hatanın ortak noktası, dosyanın boyutunun sunucunun (veya ara katmandaki bir güvenlik duvarının/CDN’in) kabul ettiği sınırı aşmasıdır. WordPress çekirdeği bu isteği hiçbir zaman görmez; bu yüzden eklenti/tema hata ayıklaması burada işe yaramaz.
413 hatası, WordPress’teki diğer yükleme hatalarından nasıl farklıdır?
WordPress’te dosya yükleme sırasında birkaç farklı hata mesajı görülebilir ve bunları karıştırmak zaman kaybettirir. 413 hatası özellikle isteğin tamamının boyutuyla ilgilidir ve istek sunucuya ulaşır ulaşmaz, PHP dosyayı işlemeye başlamadan reddedilir. Buna karşılık, medya kitaplığında sık görülen belirsiz “HTTP error” mesajı genellikle dosya sunucuya ulaştıktan sonra, görsel işleme (Imagick/GD kütüphanesi) veya bellek yetersizliği sırasında ortaya çıkar; bu farkı HTTP error görsel yükleme rehberimizde ayrıntılı olarak ele aldık. İkisini ayırt etmenin pratik yolu şudur: 413 hatası anında ve her zaman aynı eşik değerinde çıkar, “HTTP error” ise dosyadan dosyaya değişen, daha tahmin edilemez bir hatadır.
Dosyayı doğrudan FTP ile yükleyin
En hızlı çözüm, yönetim panelini tamamen devre dışı bırakmaktır. Bir eklenti veya tema ZIP dosyasını önce bilgisayarınızda açın, ardından FTP istemcinizle (FileZilla gibi) ilgili klasörün (wp-content/plugins/ veya wp-content/themes/) içine yükleyin. Medya dosyaları için aynı mantıkla wp-content/uploads/ klasörünün ilgili yıl/ay alt klasörüne yükleme yapabilirsiniz, ancak bu durumda dosyanın medya kitaplığında görünmesi için WordPress’in veritabanına da kaydedilmesi gerekir; bu yüzden medya dosyalarında FTP yöntemi yalnızca geçici bir çözümdür, kalıcı çözüm için PHP limitlerini artırmak gerekir.
PHP yükleme limitlerini artırın
Hosting panelinizde (cPanel, Plesk veya özel bir panel) genellikle bir “PHP Ayarları” veya “MultiPHP INI Editor” bölümü bulunur. Buradan iki değeri birlikte artırın:
upload_max_filesize: tek bir dosyanın izin verilen en büyük boyutupost_max_size: bu değer,upload_max_filesize’dan büyük veya ona eşit olmalıdır; aksi halde dosya kendi sınırının altında olsa da istek genel boyut sınırını aşar ve hata devam eder
Bu iki ayarın tanımı ve varsayılan değerleri PHP’nin resmî yapılandırma dosyasında (php.ini-production) açıkça belgelenmiştir; varsayılan post_max_size 8 MB, upload_max_filesize ise 2 MB’dır, bu yüzden çoğu paylaşımlı hosting hesabında bu değerler büyük tema paketleri veya yedek dosyaları için zaten yetersiz kalır. Sitenizin gerçek ihtiyacına göre 32-64 MB aralığında bir değer, çoğu kurumsal kullanım için yeterlidir; aşırı yüksek bir limit belirlemek ise sunucu kaynaklarını gereksiz yere riske atar.
Paneliniz bu seçeneği göstermiyorsa, hosting sağlayıcınızla iletişime geçip bu iki değeri hesabınız için kalıcı olarak artırmasını isteyin; paylaşımlı hosting hesaplarında bu ayarlar genellikle sağlayıcı tarafında kilitlidir.
.htaccess veya wp-config.php üzerinden deneme (ve neden önerilmez)
Bazı rehberler .htaccess dosyasına php_value upload_max_filesize satırları eklemeyi veya wp-config.php’ye ini_set() çağrıları koymayı önerir. Bu yöntemler Apache tabanlı ve suPHP/mod_php kullanan bazı sunucularda çalışabilir, ancak PHP-FPM kullanan modern sunucularda (çoğu güncel hosting ortamı) bu ayarlar genellikle göz ardı edilir ve hiçbir etkisi olmaz. .htaccess üzerinde yapılan hatalı bir değişiklik, sitenizin tamamen erişilemez hale gelmesine (500 hatası) yol açabilir. Bu yüzden önce hosting panelinizdeki resmî PHP ayarlarını, ancak panel bu seçeneği sunmuyorsa ikinci sırada bu yöntemi deneyin ve değişiklikten önce dosyanın bir kopyasını alın.
Nginx kullanıyorsanız: client_max_body_size
Sunucunuz Nginx çalıştırıyorsa (çoğu modern yönetilen WordPress hosting ortamı bunu kullanır), 413 hatasının kaynağı PHP değil, doğrudan Nginx’in kendi client_max_body_size direktifi olabilir. Bu direktif, PHP’nin yükleme limitlerinden tamamen bağımsız olarak, Nginx’in bir istek gövdesi için kabul ettiği üst sınırı belirler ve varsayılan değeri genellikle oldukça düşüktür (1 MB civarı). PHP limitlerini artırdığınız halde hata devam ediyorsa, bu değerin de sunucu yapılandırmasında yükseltilmesi gerekir; paylaşımlı hostingde bu değişikliği yalnızca sağlayıcınız yapabilir, bu yüzden destek talebinizde doğrudan bu direktifi belirtmek süreci hızlandırır.
CDN veya güvenlik duvarınızı kontrol edin
Sitenizin önünde Cloudflare gibi bir CDN veya güvenlik duvarı varsa, bu katman da kendi istek boyutu sınırını uygulayabilir ve sunucu ayarlarınızı doğru yapılandırmış olsanız bile hatayı tekrar üretebilir. Büyük bir dosya yüklerken 413 hatası alıyorsanız ve sunucu tarafındaki tüm limitler doğruysa, CDN panelinizden geçici olarak “geliştirici modu”na geçip doğrudan sunucuya erişerek test edin; sorun kaybolursa CDN’in kendi yapılandırmasını gözden geçirmeniz gerekir.
WooCommerce ve toplu içe aktarma dosyalarında dikkat edilmesi gerekenler
E-ticaret siteleri için 413 hatası sık görülen bir engeldir, çünkü ürün içe aktarma dosyaları (CSV/XML) veya tam veritabanı yedekleri genellikle tek bir medya dosyasından çok daha büyüktür. Böyle bir durumda dosyayı önce daha küçük parçalara bölerek içe aktarmak, ya da WP-CLI üzerinden komut satırından işlemi başlatmak (bu yöntem web sunucusunun istek boyutu sınırına tabi değildir) pratik bir çözüm olur. Sunucu kaynak kullanımı ve zaman aşımı konularını daha genel ele alan WordPress 502 Bad Gateway rehberimizde de görüldüğü gibi, büyük veri işlemleri genellikle birden fazla sunucu limitine aynı anda çarpar.
Hiçbir adım işe yaramazsa ne yapmalı?
Yukarıdaki adımları sırayla denediyseniz ve hata hâlâ sürüyorsa, büyük olasılıkla sunucu seviyesinde (Nginx yapılandırması veya bir ara güvenlik katmanı) sizin panelden değiştiremeyeceğiniz bir sınır devrede. Hatanın tam zamanını, yüklemeye çalıştığınız dosyanın boyutunu ve denediğiniz adımları hosting destek ekibinizle paylaşın; bu hatanın büyük kısmı, sizin erişemeyeceğiniz sunucu yapılandırma dosyalarında çözülür.
WordPress 413 Request Entity Too Large hatasını tekrar yaşamamak için
Bu hatanın çoğu, önceden alınacak basit önlemlerle engellenebilir. Hosting panelinizdeki PHP yükleme limitlerini sitenizin gerçek ihtiyacına göre (büyük eklenti paketleri, düzenli yedekleme dosyaları) kalıcı bir değere ayarlayın; medya dosyalarını yüklemeden önce sıkıştırın; düzenli büyük veri aktarımları yapıyorsanız WP-CLI gibi komut satırı araçlarını tercih edin. Bellek ve zaman aşımı kaynaklı diğer sunucu hatalarını önlemek için allowed memory size hatası rehberimize de göz atmanızı öneririz; çoğu büyük dosya işlemi, boyut sınırı ve bellek sınırını aynı anda zorlar.
Sonraki adım
WordPress 413 Request Entity Too Large hatası, WordPress’in kendisinden değil sunucunuzun yükleme limitlerinden kaynaklanan, veri kaybı riski taşımayan bir yapılandırma sorunudur. Hosting altyapınızı veya sunucu yapılandırmanızı toptan gözden geçirmek isterseniz, grup şirketimiz Web Tasarım Ofisi WordPress bakımı ve sunucu performansı konusunda destek veriyor.
Sitenizin teknik altyapısını veya özel yazılım ihtiyaçlarınızı birlikte değerlendirmek için özel yazılım hizmetimizi inceleyebilir ya da bizimle iletişime geçebilirsiniz.
Sıkça sorulan sorular
WordPress’te 413 Request Entity Too Large hatası ne anlama gelir?
Yüklemeye çalıştığınız dosyanın (eklenti, tema, medya veya içe aktarma dosyası) sunucunun tek bir istek için kabul ettiği üst sınırı aştığı anlamına gelir. Hata WordPress’in kendisinden değil, isteği karşılayan web sunucusundan (Nginx, Apache) veya PHP’nin kendisinden gelir.
413 hatası WordPress’in bir hatası mı?
Hayır. WordPress bu isteği hiç işleyemez, çünkü istek WordPress’e ulaşmadan önce sunucu veya PHP seviyesinde reddedilir. Bu yüzden eklenti devre dışı bırakmak veya tema değiştirmek bu hatayı çözmez; çözüm her zaman sunucu veya PHP yapılandırmasındadır.
Hangi PHP ayarları 413 hatasına yol açar?
İki ayar belirleyicidir: upload_max_filesize (tek bir dosyanın izin verilen en büyük boyutu) ve post_max_size (bu değer, yüklenecek dosyadan ve diğer form verilerinden en az biraz büyük olmalı, aksi halde dosya küçük görünse de hata devam eder).
Dosyayı küçültmek dışında hızlı bir çözüm var mı?
Evet. Dosyayı doğrudan FTP veya hosting panelinizin dosya yöneticisi üzerinden wp-content/uploads veya wp-content/plugins klasörüne yüklemek, PHP’nin yükleme limitine hiç takılmadan çalışır; özellikle büyük bir eklenti veya tema paketinde pratik bir geçici çözümdür.
Bu hatayı tekrar yaşamamak için ne yapmalıyım?
Hosting panelinizden PHP yükleme limitlerini sitenizin gerçek ihtiyacına göre (örneğin 32-64 MB) kalıcı olarak ayarlayın ve büyük medya dosyalarını yüklemeden önce sıkıştırın; bu iki adım 413 hatasının büyük kısmını baştan önler.