WordPress Dosya Yükleme Limiti Nasıl Artırılır?
WordPress dosya yükleme limiti nasıl artırılır? upload_max_filesize hatasını cPanel, DirectAdmin, .user.ini, .htaccess ya da kendi VDS'inizde çözün.

İçindekiler
- Limit nerede görünür?
- Limitin arkasındaki PHP ayarları
- cPanel'de limiti yükseltme
- DirectAdmin'de limiti yükseltme
- .user.ini dosyasıyla
- .htaccess ile (php_value)
- Kendi VDS'inizde: php.ini ve PHP-FPM
- 413 Request Entity Too Large: Nginx limiti
- wp-config.php limiti neden yükseltmez?
- WordPress multisite: Max upload file size
- Geçici çözüm: Büyük dosyaları SFTP ile yükleyin
- Yeni limiti doğrulayın
- Nodesty'de WordPress
WordPress dosya yükleme limiti, "The uploaded file exceeds the upload_max_filesize directive in php.ini" hatasının arkasındaki sebeptir. Bir tema, eklenti, video ya da yedek yüklemek istersiniz, WordPress ise dosya PHP'nin izin verdiğinden büyük olduğu için onu reddeder. Bu limit aslında bir WordPress ayarı değildir: birkaç PHP ayarından, bazen de PHP'nin önündeki web sunucusundan gelir.
Bu rehberde limitin nerede göründüğünü, arkasındaki PHP ayarlarını, cPanel ve DirectAdmin'de, .user.ini ya da .htaccess ile, kendi VDS'inizde PHP-FPM ve Nginx üzerinde limiti yükseltmeyi, wp-config.php dosyasının neden işe yaramadığını, multisite ayarını, büyük dosyaları SFTP ile yüklemeyi ve yeni limiti doğrulamayı anlatıyoruz.
Limit nerede görünür?
Ortam → Yeni ortam dosyası ekle (eski sürümlerde Yeni ekle) sayfasını açın. Yükleme kutusunun altında WordPress geçerli limiti yazar; İngilizce sitelerde "Maximum upload file size: 2 MB." şeklindedir. Daha büyük bir dosyada ne olacağı, dosyayı nereden yüklediğinize bağlıdır:
| Nerede? | Mesaj |
|---|---|
| Ortam yükleyicisi | video.mp4 exceeds the maximum upload size for this site. |
| Eklenti ya da tema yükleme | The uploaded file exceeds the upload_max_filesize directive in php.ini. |
post_max_size değerini aşan eklenti ya da tema | The link you followed has expired. |
| Limiti düşük bir Nginx arkasındaki her yükleme | 413 Request Entity Too Large |
Türkçe kurulu sitelerde bu mesajların çevirisi görünür, ancak upload_max_filesize gibi ayar adları aynı kalır. Dördünün de kökü aynıdır: sunucudaki bir boyut limiti dosyanızdan küçüktür.
Limitin arkasındaki PHP ayarları
Tek siteli bir kurulumda WordPress iki PHP değerini okur ve küçük olanı gösterir: upload_max_filesize ve post_max_size. Büyük bir yüklemenin gerçekten tamamlanıp tamamlanmayacağını ise üç ayar daha belirler.
| Ayar | Neyi sınırlar? | Olağan varsayılan | Makul değer |
|---|---|---|---|
upload_max_filesize | Yüklenen tek bir dosyanın boyutu | 2M | 64M |
post_max_size | İsteğin tamamı: bütün dosyalar ve form alanları | 8M | 64M |
memory_limit | Bir betiğin kullanabileceği bellek | 128M | 256M |
max_execution_time | Bir betiğin çalışabileceği süre (saniye) | 30 | 300 |
max_input_time | PHP'nin yüklemeyi okumaya ayırabileceği süre (saniye) | 60 | 300 |
post_max_size,upload_max_filesizedeğerine eşit ya da ondan büyük olmalıdır; aksi halde gerçek limitiniz küçük olan değerdir. Biraz daha büyük olmasının zararı yoktur.- PHP belgeleri,
memory_limitdeğerininpost_max_sizedeğerinden büyük tutulmasını önerir. - Süre sınırları yavaş bağlantılarda ve yüklemeden sonraki işlerde, örneğin bir temanın arşivden çıkarılmasında ya da görsel boyutlarının oluşturulmasında önem kazanır.
- Değerleri en büyük dosyanıza göre seçin. Çok yüksek sınırlar, hatalı ya da kötü niyetli tek bir isteğin sunucu kaynaklarını tüketmesine yol açabilir.
cPanel'de limiti yükseltme
- Software bölümündeki MultiPHP INI Editor ekranını açın.
- Basic Mode sekmesinde konum menüsünden alan adınızı seçin.
upload_max_filesizevepost_max_sizedeğerlerini, gerekiyorsamemory_limit,max_execution_timevemax_input_timedeğerlerini de girin.- Apply düğmesine tıklayın.
cPanel bu değerleri o klasördeki php.ini, .user.ini ve .htaccess dosyalarına sizin yerinize yazar; bu yüzden oluşturduğu bloğu elle düzenlemeyin. CloudLinux kullanan sunucularda Select PHP Version → Options ekranını açıp değerleri listelerden seçin; bu seçenekler seçili PHP sürümüne aittir, sürüm değiştirirseniz yeniden ayarlamanız gerekir. İki ekranı da PHP sürümü değiştirme rehberimizde anlattık. İhtiyacınız olan değer listede yoksa ya da etkili olmuyorsa sağlayıcınız paketiniz için bir üst sınır koymuştur; destek ekibine yazın.
DirectAdmin'de limiti yükseltme
DirectAdmin'in görünümü kullanılan temaya ve sağlayıcınızın açtığı özelliklere göre değişir. Sık karşılaşılan iki yer vardır:
- PHP Settings (PHP ayarları): Alan adını seçin, listeden ayarı (örneğin
upload_max_filesize) yeni değeriyle ekleyin ve kaydedin. Her alan adı kendi değerlerini ayrı tutar. - Select PHP Version → Options: CloudLinux kullanan sunucularda cPanel'deki ekranın aynısıdır.
İkisi de yoksa ya da aradığınız ayar listede bulunmuyorsa aşağıdaki .user.ini yöntemini kullanın veya sağlayıcınıza danışın; sunucu genelindeki php.ini dosyası yöneticinin elindedir.
.user.ini dosyasıyla
PHP-FPM, FastCGI ve LiteSpeed ile çalışan sitelerde PHP, site klasöründeki .user.ini dosyasını okur. Dosyayı sitenin kök klasöründe (genellikle public_html, wp-config.php dosyasının yanı) dosya yöneticisiyle ya da SFTP ile oluşturun:
upload_max_filesize = 64M
post_max_size = 64M
memory_limit = 256M
max_execution_time = 300
max_input_time = 300
PHP bu dosyayı önbelleğe alır ve varsayılan olarak beş dakikada bir yeniden okur (user_ini.cache_ttl); kontrol etmeden önce birkaç dakika bekleyin. PHP bir Apache modülü (mod_php) olarak çalışıyorsa .user.ini okunmaz; ayrıca sunucu yöneticisinin kilitlediği sınırların üzerine çıkamaz.
.htaccess ile (php_value)
PHP bir Apache modülü (mod_php) olarak çalışıyorsa ya da site LiteSpeed üzerindeyse değerleri sitenin kök klasöründeki .htaccess dosyasına yazabilirsiniz. Satırları # BEGIN WordPress satırının üstüne ekleyin, çünkü WordPress kendi işaretleri arasındaki bloğu yeniden yazabilir:
php_value upload_max_filesize 64M
php_value post_max_size 64M
php_value memory_limit 256M
php_value max_execution_time 300
php_value max_input_time 300
Uyarı: PHP-FPM ya da başka bir CGI kurulumu kullanan Apache sunucularında Apache php_value komutunu tanımaz ve sitenin tamamı 500 Internal Server Error verir (hata günlüğünde Invalid command 'php_value' yazar). Satırları silin, site geri gelir; bu sunucularda .user.ini kullanın. Nginx ise .htaccess dosyasını hiç okumaz. Sitenizin hangisiyle çalıştığından emin değilseniz Araçlar → Site sağlığı → Bilgi sekmesindeki Sunucu bölümünde PHP SAPI satırına bakın: apache2handler mod_php, fpm-fcgi PHP-FPM, litespeed ise LiteSpeed demektir.
Kendi VDS'inizde: php.ini ve PHP-FPM
Ubuntu ve Debian'da her PHP sürümünün ve PHP'nin her çalışma biçiminin ayrı bir php.ini dosyası vardır. PHP 8.3 ile PHP-FPM için bu dosya /etc/php/8.3/fpm/php.ini yolundadır; kurulu sürümleri ls /etc/php/ ile görebilirsiniz. /etc/php/8.3/cli/php.ini yalnızca komut satırı için geçerlidir; php -i çıktısının siteden farklı değerler gösterebilmesinin sebebi budur.
sudo nano /etc/php/8.3/fpm/php.ini
Mevcut satırları bulup değiştirin, gerekiyorsa tablodaki diğer değerleri de güncelleyin:
upload_max_filesize = 64M
post_max_size = 64M
PHP-FPM dosyayı yalnızca başlarken okur, bu yüzden yeniden başlatın:
sudo systemctl restart php8.3-fpm
Apache ve mod_php kullanıyorsanız dosya /etc/php/8.3/apache2/php.ini yolundadır ve sudo systemctl restart apache2 ile yeniden başlatırsınız. AlmaLinux'ta dosya /etc/php.ini, servisin adı ise php-fpm olur.
413 Request Entity Too Large: Nginx limiti
Nginx'in client_max_body_size adında kendi limiti vardır ve varsayılanı yalnızca 1 MB'tır. Daha büyük bir istek PHP'ye hiç ulaşmaz: Nginx 413 Request Entity Too Large yanıtını verir, ortam yükleyicisi ise bunu çoğu zaman yalnızca genel bir HTTP hatası olarak gösterir. Bu, upload_max_filesize ayarından farklı bir limittir; ikisini de yükseltmeniz gerekir. Satırı /etc/nginx/nginx.conf içindeki http bloğuna ya da sitenin server bloğuna ekleyin:
client_max_body_size 64m;
sudo nginx -t
sudo systemctl reload nginx
Nginx, Apache'nin ya da bir konteynerin önünde reverse proxy olarak çalışıyorsa limit orada da geçerlidir; yapılandırmayı Nginx kurulumu rehberimizde anlattık. Cloudflare gibi bir proxy hizmeti de kendi yükleme sınırını ekler; ücretsiz planda bu sınır 100 MB'tır.
wp-config.php limiti neden yükseltmez?
Pek çok rehber wp-config.php dosyasına ya da temanın functions.php dosyasına @ini_set( 'upload_max_filesize', '64M' ); gibi bir satır eklemeyi önerir. Bu satırın bir etkisi olmaz: PHP yüklemeyi WordPress'in ilk satırı çalışmadan önce alır ve denetler, upload_max_filesize ile post_max_size de çalışma sırasında ini_set() ile değiştirilemez. Bu ayarlar yalnızca php.ini, .user.ini ya da web sunucusu yapılandırması üzerinden tanımlanabilir.
define( 'WP_MEMORY_LIMIT', '256M' ); gerçek bir ayardır, ancak yalnızca WordPress'in istediği belleği yükseltir; bu da WordPress kritik hata rehberimizdeki bellek hatalarında işe yarar. Yükleme limiti olduğu yerde kalır. Eklentiler de PHP'nin limitini değiştiremez; bazıları dosyayı küçük parçalar halinde göndererek limitin etrafından dolaşır, ancak sunucu ayarını düzeltmek daha temiz bir çözümdür.
WordPress multisite: Max upload file size
Multisite ağlarında PHP limitinin üzerine bir limit daha gelir. Ağ yönetiminde Ayarlar → Ağ ayarları (Network Admin → Settings → Network Settings) sayfasını açın ve yükleme ayarları (Upload Settings) altındaki Max upload file size alanını bulun. Değer KB cinsindendir ve varsayılanı 1500 KB, yani yaklaşık 1,5 MB'tır; bu yüzden PHP 64 MB'a izin verse bile yeni bir ağın siteleri bu limitte kalır. 64 MB için örneğin 65536 yazıp kaydedin. Her zaman iki limitten küçük olanı geçerlidir; aynı bölümdeki Site upload space ayarı da site başına toplam alanı ayrıca sınırlayabilir.
Geçici çözüm: Büyük dosyaları SFTP ile yükleyin
Tek bir büyük dosya için hiçbir ayarı yükseltmeniz gerekmez:
- Eklentiler ve temalar: Arşivi bilgisayarınızda açın, klasörü SFTP ile
wp-content/pluginsya dawp-content/themesiçine yükleyin ve wp-admin'den etkinleştirin. - Sitenin tamamı: Gigabaytlarca büyüklükteki bir yedeği bir eklentinin yükleme formundan geçirmeyin. Dosyaları ve veritabanını web sitesi taşıma rehberimizde anlattığımız gibi doğrudan taşıyın.
- Ortam dosyaları:
wp-content/uploadsiçine kopyalanan bir dosya ortam kütüphanesinde kendiliğinden görünmez, çünkü her öğenin veritabanında bir kaydı olmalıdır. Dosyayı ana klasörünüze yükleyin ve SSH üzerinden WP-CLI ile kaydedin:
cd ~/public_html
wp media import ~/big-video.mp4
wp media import dosyayı uploads klasörüne kopyalar ve kütüphane kaydını oluşturur; dosya zaten wp-content/uploads içindeyse --skip-copy ekleyin.
Yeni limiti doğrulayın
- Ortam → Yeni ortam dosyası ekle: Yükleme kutusunun altındaki sayı yeni değeri göstermelidir.
- Araçlar → Site sağlığı → Bilgi: Sunucu bölümünde
upload_max_filesize,post_max_size,memory_limit,max_execution_timevemax_input_timedeğerleri listelenir (İngilizce sitelerde "Upload max filesize", "PHP post max size" gibi satırlar). Bu sayfa için yönetici hesabı gerekir; hesabınıza giremiyorsanız WordPress şifre sıfırlama rehberimize göz atın.
Eski değer hâlâ duruyorsa olağan şüphelilere bakın: post_max_size hâlâ düşüktür, .user.ini önbelleğinin süresi dolmamıştır, başka bir PHP sürümünün ya da komut satırının php.ini dosyasını düzenlemişsinizdir, PHP-FPM yeniden başlatılmamıştır, sağlayıcı değere üst sınır koymuştur ya da multisite ayarı daha düşüktür.
Nodesty'de WordPress
Nodesty web hosting paketleri, WordPress sitelerini AMD Ryzen 9 7900 işlemcili sunucularda LiteSpeed web sunucusu ve NVMe diskle çalıştırır. PHP sürümünü seçmeyi, upload_max_filesize ve post_max_size gibi php.ini ayarlarını düzenlemeyi cPanel ya da DirectAdmin üzerinden yaparsınız; ücretsiz SSL, Imunify360 ve JetBackup yedekleri paketlere dahildir. php.ini dosyasından client_max_body_size değerine kadar her limiti kendiniz belirlemek isterseniz AMD Ryzen 9 9950X VDS paketlerimiz tam root erişimi ve 7 gün saklanan ücretsiz günlük yedekler sunar. Sıfırdan kurulumu WordPress kurulumu rehberimizde anlattık; site bunun yerine bir veritabanı mesajı gösteriyorsa WordPress veritabanı bağlantı hatası rehberimize bakın.
Sıkça Sorulan Sorular
WordPress'te varsayılan dosya yükleme limiti nedir?
Tek siteli bir kurulumda WordPress'in kendine ait sabit bir limiti yoktur. upload_max_filesize ve post_max_size adlı iki PHP ayarından küçük olanı gösterir. PHP'nin kendi varsayılanları 2 MB ve 8 MB'tır, hosting sağlayıcıları ise genellikle daha yüksek değerler tanımlar; limitin firmadan firmaya değişmesinin sebebi budur.
The uploaded file exceeds the upload_max_filesize directive in php.ini hatası ne anlama gelir?
Yüklemeye çalıştığınız dosya, upload_max_filesize adlı PHP ayarının izin verdiğinden büyüktür ve PHP dosyayı WordPress işleyemeden reddetmiştir. upload_max_filesize ve post_max_size değerlerini kontrol panelinden, bir .user.ini dosyasıyla ya da php.ini içinden yükseltin veya dosyayı SFTP ile yükleyin.
Değerleri değiştirdim ama limit aynı kaldı, neden?
En sık görülen sebepler şunlardır. post_max_size hâlâ upload_max_filesize değerinden düşüktür, değişiklik başka bir PHP sürümü için ya da komut satırının php.ini dosyasında yapılmıştır, PHP-FPM yeniden başlatılmamıştır veya .user.ini dosyası henüz yeniden okunmamıştır; bu beş dakika sürebilir. Paylaşımlı hostingde sağlayıcı değere üst sınır koymuş olabilir, multisite kurulumlarda ise ağ ayarı ayrıca geçerlidir.
Yükleme limitini wp-config.php dosyasından artırabilir miyim?
Hayır. upload_max_filesize ve post_max_size betik çalışırken değiştirilemez; bu yüzden wp-config.php ya da functions.php içine yazılan ini_set satırlarının bir etkisi olmaz. WP_MEMORY_LIMIT yalnızca bellek sınırını yükseltir. Yükleme limiti php.ini, .user.ini, .htaccess ya da kontrol paneli üzerinden değiştirilmelidir.
upload_max_filesize hatası ile 413 Request Entity Too Large arasındaki fark nedir?
İlki PHP'den, ikincisi web sunucusundan gelir. Nginx, varsayılanı 1 MB olan client_max_body_size değerinden büyük her isteği PHP'ye ulaşmadan reddeder. Kendi sunucunuzda iki limiti de yükseltmeniz gerekir; yalnızca birini yükseltmek diğerini yerinde bırakır.
Yükleme limitini ne kadar yüksek ayarlamalıyım?
Gerçekten yüklediğiniz en büyük dosyanın biraz üzerinde. Çoğu site için 64 MB yeterlidir, büyük temalar ve yedekler için 128 ya da 256 MB iş görür. Aşırı yüksek değerlerden kaçının; tek bir isteğin belleği, disk alanını ve PHP işçilerini meşgul etmesine yol açarlar. Ara sıra yüklenen çok büyük dosyalar için SFTP daha doğru araçtır.
Yazar hakkında
Nodesty Ekibi · Altyapı ve Destek
Nodesty ekibi sunucularımızı, ağımızı ve DDoS korumamızı her gün işletir ve müşteri destek taleplerini 7/24 yanıtlar. Bu rehberler o deneyimden yazılır.
İlgili yazılar

502 Bad Gateway Hatası: Sebepleri ve Çözümü
502 Bad Gateway hatası mı alıyorsunuz? Nginx hata günlüğünü okuma, PHP-FPM ya da uygulamayı başlatma, port ve soket, pm.max_children, Cloudflare kontrolü.

WordPress Şifre Sıfırlama: Yönetici Hesabına Yeniden Girin
WordPress'e giremiyor musunuz? Yönetici şifresini şifremi unuttum bağlantısı, WP-CLI, phpMyAdmin ya da MySQL ile sıfırlayın veya yeni yönetici oluşturun.

Bu Sitede Kritik Bir Hata Oluştu: WordPress Çözümü
WordPress bu sitede kritik bir hata oluştu mu diyor? WP_DEBUG ile asıl PHP hatasını bulun, eklentileri ya da temayı kapatın ve bellek sınırını düzeltin.