Yüklenen Dosya upload_max_filesize Yönergesini Aşıyor Hatası
- Yayınlandı:
- Son teknik kontrol:
The uploaded file exceeds the upload_max_filesize directive in php.ini.Belirtiler
- Medya yüklerken “upload_max_filesize yönergesini aşıyor” mesajı
- Medya → Yeni ekle ekranında düşük bir “En büyük yükleme dosyası boyutu” değeri
- Tema veya eklenti zip dosyası yüklenemiyor
- Büyük dosyalarda “413 Request Entity Too Large” hatası (sunucu sınırı)
Kısa cevap
Bu hata, yüklemeye çalıştığınız dosyanın sunucudaki PHP’nin izin verdiği en büyük dosya boyutundan (upload_max_filesize) büyük olduğunu söyler; WordPress’ten değil PHP ayarından kaynaklanır. PHP’nin varsayılan değeri 2 MB’tır. Sınır, hosting panelinin PHP ayarlarından veya sunucu yapılandırmasına göre .user.ini ya da php.ini dosyasıyla artırılır; bunu yaparken post_max_size değerinin de en az aynı büyüklükte olması gerekir. Görseller için sınırı artırmak yerine dosyayı küçültmek çoğu zaman daha doğrudur.
Önemli noktalar
- Sınır PHP’ye aittir; WordPress yalnızca PHP’nin döndürdüğü hatayı gösterir.
- upload_max_filesize ile birlikte post_max_size da artırılmalı (post_max_size ≥ upload_max_filesize).
- PHP-FPM kullanan sunucularda .htaccess içindeki php_value satırları 500 hatası verir.
- 413 hatası PHP’den değil, web sunucusunun (Nginx) istek boyutu sınırından gelir.
- Büyük görselleri küçültmek, sınırı artırmaktan hem hızlı hem daha sağlıklıdır.
Mevcut sınırı öğrenin
Medya → Yeni ekle ekranının altında “En büyük yükleme dosyası boyutu” yazar. Ayrıntılı değerler Araçlar → Site Sağlığı → Bilgi → Sunucu bölümündedir (yükleme sınırı, gönderi boyutu, bellek sınırı).
| Ayar | Varsayılan | Görevi |
|---|---|---|
upload_max_filesize | 2M | Tek bir yüklenen dosyanın en büyük boyutu |
post_max_size | 8M | Bir isteğin tüm gövdesi — upload_max_filesize’dan büyük olmalı |
memory_limit | 128M | PHP betiğinin kullanabileceği bellek — post_max_size’dan büyük olmalı |
max_execution_time | 30 sn | Büyük dosyaların işlenmesi zaman aşımına uğrayabilir |
Hosting firmaları bu değerleri genellikle varsayılandan yüksek ayarlar; gördüğünüz değer sağlayıcınızın ayarıdır.
Sınırı artırma yolları
Hosting panelinden (önerilen)
cPanel’de “PHP Seçenekleri” / “MultiPHP INI Düzenleyicisi”, Plesk’te alan adının PHP ayarları. upload_max_filesize ve post_max_size değerlerini birlikte artırın.
.user.ini dosyası (PHP-FPM / CGI)
Panelde seçenek yoksa sitenin kök dizinine .user.ini dosyası oluşturup değerleri yazın. Değişikliğin etkinleşmesi birkaç dakika sürebilir.
php.ini (kendi sunucunuz)
VPS veya kendi sunucunuzda ana php.ini dosyasını düzenleyip PHP-FPM’i yeniden başlatın.
upload_max_filesize = 64M
post_max_size = 64M
memory_limit = 256M
max_execution_time = 120413 Request Entity Too Large farklıdır
PHP sınırını artırdığınız hâlde büyük dosyalarda “413” görüyorsanız istek PHP’ye ulaşmadan web sunucusunda reddediliyordur. Nginx’te bu sınır client_max_body_size ayarıdır; paylaşımlı hosting’de hosting firmasının değiştirmesi gerekir. CDN’lerin de istek boyutu sınırları vardır.
Sınırı artırmak yerine dosyayı küçültmek
Hata bir fotoğrafta çıkıyorsa sorun çoğu zaman sınır değil, dosyanın gereğinden büyük olmasıdır. Web için 4000 piksellik, birkaç megabaytlık bir fotoğrafa ihtiyaç yoktur. Görselleri yüklemeden önce küçültmek hem bu hatayı hem sitenin yavaşlamasını önler; ayrıntılar WordPress resim optimizasyonu rehberinde.