Fayl yükləmə limiti: upload_max_filesize və 413 xətasının həlli

WordPress-ə böyük şəkil, video və ya arxiv yükləyərkən "fayl icazə verilən maksimum ölçünü keçir" yazısı, yaxud brauzerdə 413 Request Entity Too Large xətası çıxırsa, problem fayldan yox, serverdəki limitlərdən irəli gəlir. Qısa cavab belədir: PHP-də upload_max_filesize və post_max_size dəyərlərini artırmaq, 413 görünürsə veb serverin sorğu həcmi limitini də qaldırmaq lazımdır. Aşağıda bunu cPanel-də, WordPress-də və öz VPS-inizdə necə edəcəyinizi addım-addım göstəririk.

Hansı parametr nəyə cavabdehdir

Fayl yükləmə zamanı bir neçə PHP parametri birlikdə işləyir. Onlardan biri kiçik qalsa, qalanlarını nə qədər artırsanız da yükləmə alınmayacaq.

Əsas qayda: post_max_size həmişə upload_max_filesize-dan böyük olmalıdır, çünki forma faylla yanaşı başqa sahələr də göndərir. PHP sənədləri memory_limit-in də post_max_size-dan böyük olmasını tövsiyə edir. Ölçüləri M (meqabayt) və ya G (giqabayt) hərfi ilə yazın, "MB" kimi yazılış PHP tərəfindən düzgün oxunmaya bilər.

Hazırkı limiti necə öyrənmək olar

WordPress-də ən sadə yol Media > Yeni əlavə et səhifəsidir: yükləmə sahəsinin altında maksimum fayl ölçüsü yazılır. Daha ətraflı məlumat Alətlər > Sayt sağlamlığı (Site Health) > Məlumat > Server bölməsindədir, orada PHP versiyası, yaddaş və yükləmə limitləri göstərilir.

WordPress olmayan saytda public_html qovluğunda müvəqqəti info.php faylı yaradın:

<?php phpinfo();

Faylı brauzerdə açıb upload_max_filesize sətrini axtarın. Yoxladıqdan sonra faylı mütləq silin, çünki o, server haqqında həssas məlumatları hamıya göstərir.

cPanel-də limiti artırmaq

Select PHP Version və ya MultiPHP INI Editor

Server quruluşundan asılı olaraq bu tənzimləmələr cPanel-də iki fərqli alətdə ola bilər. Hər ikisi lazımi faylı özü yazır, ona görə ilk növbədə onlardan istifadə edin.

1. cPanel-ə daxil olun və Software bölməsində Select PHP Version və ya MultiPHP INI Editor alətini açın.
2. Select PHP Version-da Options tabına keçin. MultiPHP INI Editor-da isə Basic Mode bölməsində domeni seçin.
3. upload_max_filesize, post_max_size, memory_limit və max_execution_time üçün yeni dəyərləri təyin edin.
4. MultiPHP INI Editor-da Apply düyməsini basın. Select PHP Version-da dəyişiklik seçən kimi yadda saxlanılır.
5. WordPress-də Media səhifəsini yeniləyib yeni limiti yoxlayın.

Eyni bölmədə PHP versiyası da seçilir. Hansı versiyanın sayt üçün uyğun olduğunu 2026-cı ildə PHP versiyası seçimi yazısında izah etmişik.

.user.ini faylı ilə

Belə alət yoxdursa, saytın kök qovluğunda (adətən public_html) .user.ini adlı fayl yaradıb bu sətirləri yazın:

upload_max_filesize = 64M
post_max_size = 80M
memory_limit = 256M
max_execution_time = 300
max_input_time = 300

PHP bu faylı keşlədiyi üçün dəyişikliyin təsiri 5 dəqiqəyə qədər gecikə bilər. Bəzi bələdçilər eyni dəyərləri .htaccess-ə php_value ilə yazmağı məsləhət görür, lakin PHP işləyicisi bunu dəstəkləmirsə, sayt dərhal 500 xətası verəcək. Paylaşılan hostinqdə paketin öz yuxarı həddi də ola bilər: ondan böyük dəyər yazsanız, tətbiq olunmayacaq.

WordPress-də nəyi dəyişmək olar, nəyi yox

İnternetdə tez-tez wp-config.php-yə ini_set('upload_max_filesize', ...) yazmaq məsləhəti görünür. Bu işləmir: upload_max_filesize və post_max_size skript işə düşəndən sonra dəyişdirilə bilməyən parametrlərdir, onlar yalnız server və ya qovluq səviyyəsində təyin olunur. Limiti "artıran" plaginlər də əslində serverin icazə verdiyi həddən o yana keçə bilmir.

Yaddaş limiti isə fərqlidir. WordPress-in özünə ayırdığı yaddaşı wp-config.php-də "That's all, stop editing!" sətrindən əvvəl artırmaq olar:

define( 'WP_MEMORY_LIMIT', '256M' );

Bu dəyər serverdəki memory_limit-dən böyük ola bilməz. Böyük yükləmədən sonra idarə paneli ağ ekranla açılırsa, səbəb çox vaxt yaddaşdır: ətraflı diaqnostika üçün wp-admin açılmır: WordPress admin girişi problemlərinin həlli bələdçisinə baxın.

413 Request Entity Too Large: veb serverin limiti

413 xətası sorğu PHP-yə çatmamış qaytarılır, yəni onu veb serverin özü rədd edir. Nginx-də bu limit client_max_body_size parametridir və standart dəyəri cəmi 1 MB-dır. Apache-də LimitRequestBody, LiteSpeed-də isə server səviyyəsində sorğu gövdəsinin maksimum ölçüsü bu işi görür.

Paylaşılan hostinqdə veb serverin tənzimləmələrinə girişiniz olmur, ona görə 413 görsəniz, dəstəyə yazın. Sayt Cloudflare proksisi arxasındadırsa, nəzərə alın ki, pulsuz planda bir sorğunun həcmi 100 MB ilə məhdudlaşır.

Öz VPS-inizdə (Ubuntu 24.04, Nginx və PHP 8.3-FPM) əvvəlcə /etc/nginx/nginx.conf faylında http blokunun içinə bu sətri əlavə edin:

client_max_body_size 64M;

Sonra /etc/php/8.3/fpm/php.ini faylında upload_max_filesize və post_max_size dəyərlərini dəyişin, yoxlayın və xidmətləri yenidən yükləyin:

sudo nano /etc/nginx/nginx.conf
sudo nano /etc/php/8.3/fpm/php.ini
grep -E "^(upload_max_filesize|post_max_size)" /etc/php/8.3/fpm/php.ini
sudo nginx -t
sudo systemctl reload nginx
sudo systemctl restart php8.3-fpm

Apache istifadə edirsinizsə, fayl /etc/php/8.3/apache2/php.ini, yenidən başlatma əmri isə sudo systemctl restart apache2 olacaq.

Çox böyük fayllar: brauzer yox, FTP

Yüzlərlə meqabaytlıq videonu, sayt yedəyini və ya arxivi brauzerlə yükləmək həm yavaşdır, həm də bağlantı qırılanda hər şey yenidən başlayır. Belə fayllar üçün limiti şişirtmək əvəzinə FTP və ya SFTP istifadə edin: proqram yarımçıq qalan yükləməni davam etdirə bilir. Addımları FTP nədir və FileZilla ilə faylları serverə necə yükləmək olar yazısında göstərmişik.

FTP ilə wp-content/uploads qovluğuna atılan fayl WordPress-in Media kitabxanasında avtomatik görünmür. VPS-də WP-CLI quraşdırılıbsa, faylı kitabxanaya belə əlavə edə bilərsiniz:

wp media import /home/istifadeci/video.mp4 --path=/var/www/sayt

Videonu birbaşa sayta yükləmək əvəzinə YouTube-da yerləşdirib səhifəyə əlavə etmək də çox vaxt daha yaxşı seçimdir. Böyük, sıxılmamış şəkillər isə səhifəni ağırlaşdırır: bunun sürətə təsirini Google Search Console-dakı Core Web Vitals hesabatından izləmək olar.

Tez-tez verilən suallar

upload_max_filesize üçün hansı dəyəri seçmək məsləhətdir?

Adi korporativ sayt və bloq üçün 32M-64M kifayətdir. Daha böyük dəyər yalnız real ehtiyac olanda lazımdır, çünki çox yüksək limitlər serveri yükləyən sorğulara da yol açır.

Dəyəri dəyişdim, amma WordPress köhnə limiti göstərir. Niyə?

Ya post_max_size kiçik qalıb, ya .user.ini keşi hələ yenilənməyib, ya da dəyişikliyi səhv qovluqda etmisiniz. Bir neçə dəqiqə gözləyin və hər iki parametri phpinfo() ilə yoxlayın.

413 xətası ilə "fayl limiti keçir" xəbərdarlığı eyni şeydir?

Xeyr. Birincisi veb serverin, ikincisi PHP-nin limitidir. 413 görürsünüzsə, PHP dəyərlərini artırmaq tək başına kömək etməyəcək.

Əlaqə formasından göndərilən fayllar e-poçta gəlmir, bu da limitdir?

Ola bilər, çünki həm yükləmə limiti, həm də e-poçt qoşmasının ölçüsü məhduddur. Məktublar ümumiyyətlə gəlmirsə, problem göndərişdədir: WordPress e-poçt göndərmir: WP Mail SMTP ilə həll yazısına baxın.

Böyük media faylları ilə işləyən saytlar üçün cPanel, LiteSpeed və SSD RAID10 üzərində qurulan Hostinq.az hostinq paketlərinə baxın. Limitlə bağlı sualınız olsa, 24/7 Azərbaycan dilində dəstək WhatsApp-da (+994 77 711 22 44) kömək edir.