Blog’a Dön

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.

Nodesty Ekibi8 dk okumaHosting
Koyu Nodesty arka planında WordPress Upload Limit yazısı ile upload_max_filesize ifadesi

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ükleyicisivideo.mp4 exceeds the maximum upload size for this site.
Eklenti ya da tema yüklemeThe uploaded file exceeds the upload_max_filesize directive in php.ini.
post_max_size değerini aşan eklenti ya da temaThe link you followed has expired.
Limiti düşük bir Nginx arkasındaki her yükleme413 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.

AyarNeyi sınırlar?Olağan varsayılanMakul değer
upload_max_filesizeYüklenen tek bir dosyanın boyutu2M64M
post_max_sizeİsteğin tamamı: bütün dosyalar ve form alanları8M64M
memory_limitBir betiğin kullanabileceği bellek128M256M
max_execution_timeBir betiğin çalışabileceği süre (saniye)30300
max_input_timePHP'nin yüklemeyi okumaya ayırabileceği süre (saniye)60300
  • post_max_size, upload_max_filesize değ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_limit değerinin post_max_size değ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

  1. Software bölümündeki MultiPHP INI Editor ekranını açın.
  2. Basic Mode sekmesinde konum menüsünden alan adınızı seçin.
  3. upload_max_filesize ve post_max_size değerlerini, gerekiyorsa memory_limit, max_execution_time ve max_input_time değerlerini de girin.
  4. 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/plugins ya da wp-content/themes iç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/uploads iç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_time ve max_input_time değ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.

Nodesty

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

Sunucunuzu şimdi başlatın.

Nodesty'nin üstün altyapısı ile projelerinizi özgürce inşa edin ve sınır tanımadan ölçeklendirin.

                                                                                                                                                                                                                            
                                                                                                                                                                                                                            
                                                                                                                                                                                                                            
                                                                                                                             ············································                                                   
                                                ··································································································..........···························                                     
                                       ················..........................................................................................................................··············                             
                                  ·············.................::::::::::::::::::::::::::::::::::::::::::::::....................:::::::::::::::::::::::::::::::::::::::................···········                        
                             ············................:::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::............·········                     
                         ············.................:::::::::::::::::::::::::::::::::::::::::::::::::::------------::::::::::::::::::::::::::::::----------------:::::::::::::::::::::..........········                  
                    ············......................::::::::::::::::::::::::::::::::::::------------------------------------------------------------------------------------:::::::::::::.........········                
                ··········.............................................::::::::::::::::::-------------==========================================-----------------------------------:::::::::::........·······               
             ········..................:.....................................::::::::::--------=======+++++++++++++++++++++++++++++++++++++=========================------------------::::::::::.......·······              
           ······.........::::::::::::::::::::................................:::::::-----=====++++xxxxxx**************************xxxxxxxxx++++++++++++++===================------------::::::::.......·······             
          ·····.......:::::::::::::::::::::::::::.............................:::::----===+++xxx****%%%%&&&&&&#############&&&&&&&%%%%%*******xxxxxxxx++++++++++++++==============----------:::::::......······             
         ····......::::::::-------------:::::::::::..........................::::---===+++xx***%%%&&&####@@@@@@@@@@@@@@@@@@@@@@@@####&&&&&%%%%*******xxxxxxxxx+++++++++++++===========--------::::::......·····             
        ····.....:::::::--------------------:::::::::.......................::::---===++xxx**%%&&&###@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@###&&&&%%%%%********xxxxxxxxxxx++++++++++++========------::::::.....······            
        ····.....:::::--------------------------::::::::....................::::---===++xx***%%&&&####@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@###&&&&&%%%%%**********xxxxxxxxxxxxx+++++++++=======------:::::.....·····            
        ····....::::::-------=============---------:::::::::................:::::---===+++xx***%%%&&&#####@@@@@@@@@@@@@@@@@@@@@@@@@#####&&&&&%%%%%%*************xxxxxxxxxxxxxx+++++++++======-----:::::....·····            
         ····....:::::-------================---------:::::::::...............:::::----===++++xxx***%%%%&&&&&&#################&&&&&&%%%%%%%*******************xxxxxxxxxxxxxxxxx++++++++======----:::::....·····            
         ·····....:::::--------=================---------::::::::::..............:::::::-----====+++++xxxxxx**************************xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx++++++++=====-----::::....·····            
          ·····.....:::::--------=================----------:::::::::::.................:::::::::-------=============++++++++++++++++++++++++++++++++++++xxxxxxxxxxxxxxxxxxxxxxx++++++++======-----::::....·····            
            ·····.....:::::::----------===========-------------::::::::::::.........................::::::::::::::::::------------------=============+++++++++++++++++++++++++++++++++=======-----::::.....·····            
              ······......:::::::---------------------------------:::::::::::::........................................:::::::::::::::-----------============+++++++++++++++++++++========------:::::.....·····             
                 ······........:::::::::---------------------------:::::::::::::::::...........................................:::::::::::::------------=============================--------::::::.....······              
                    ·········.........:::::::::::::::-------------::::::::::::::::::::::::.......................................::::::::::::::::--------------------------------------::::::::......·······                
                          ··········............::::::::::::::::::::::::::::::::::::::::::::::::::................................::::::::::::::::::::::::::-------------:::::::::::::::.........········                   
                                  ············..................:::::::::::::::::::::::::::::::::::::::::::.........................:::::::::::::::::::::::::::::::::::::................···········                        
                                             ················.............................................................................................................·················                                 
                                                           ······················................................................................···························                                                
                                                                               ·········································································