Перейти до змісту
Пошта Кабінет Обрати тариф

upload_max_filesize: як збільшити ліміт завантаження і прибрати 413

upload_max_filesize: як збільшити ліміт завантаження і прибрати 413

upload_max_filesize: директива PHP, яка обмежує розмір одного завантажуваного файлу (типово 2M). Щоб збільшити ліміт, підніміть разом upload_max_filesize і post_max_size (другий має бути більшим) у php.ini, .user.ini або в панелі хостингу. Якщо ж браузер показує 413 Request Entity Too Large, файл відсікає вебсервер ще до PHP: у Nginx збільште client_max_body_size (типово 1m), в Apache LimitRequestBody.

Нижче: як за кілька хвилин визначити, який саме ліміт спрацював, де його змінити на віртуальному хостингу і на VPS, чому популярні поради з ini_set() не працюють і як завантажити великий файл, взагалі не чіпаючи налаштувань сервера.

Що означає помилка 413 і чим вона відрізняється від ліміту PHP

Код 413 сервер повертає тоді, коли тіло запиту (файл разом з іншими полями форми) більше, ніж він погоджується прийняти. У чинному стандарті HTTP (RFC 9110) цей код називається Content Too Large, але Nginx і більшість хостингів досі показують стару назву Request Entity Too Large. Головне: 413 генерує вебсервер або проксі, а не PHP. Тому скільки б ви не змінювали php.ini, помилка 413 від Nginx не зникне, доки не змінено налаштування самого Nginx.

Ліміти PHP працюють інакше: вебсервер приймає запит, PHP бачить завеликий файл і відкидає його. Сайт при цьому відповідає звичайною сторінкою, а помилку видно в інтерфейсі CMS або в логах. За текстом повідомлення легко зрозуміти, куди дивитися:

Що ви бачите Хто відхилив файл Що змінювати
Сторінка «413 Request Entity Too Large» з підписом nginx Nginx client_max_body_size
Сторінка 413 з логотипом Cloudflare Cloudflare ліміт тарифу Cloudflare або завантаження в обхід проксі
«The uploaded file exceeds the upload_max_filesize directive in php.ini» PHP upload_max_filesize
«The link you followed has expired» у WordPress, порожні $_POST і $_FILES, у лозі «POST Content-Length … exceeds the limit» PHP post_max_size
«… exceeds the maximum upload size for this site» WordPress за лімітами PHP upload_max_filesize і post_max_size, у мультисайті ще й налаштування мережі
«HTTP error» у медіабібліотеці WordPress найчастіше Nginx (413), тайм-аут або нестача пам’яті client_max_body_size, тайм-аути, memory_limit
phpMyAdmin пише «Max: 2,048KiB» біля імпорту PHP upload_max_filesize і post_max_size
413 на файлах від 12,5 МБ, хоча Nginx і PHP налаштовані ModSecurity (WAF) SecRequestBodyLimit

Ланцюжок лімітів: від браузера до PHP

Дорогою до сайту файл проходить кілька «шлагбаумів», і пропускна здатність усього ланцюжка дорівнює найменшому з них. Якщо підняти upload_max_filesize до 256M, а Nginx залишити з 1m, завантаження впаде на першому ж кроці.

Ланцюжок лімітів завантаження файлу: Cloudflare, Nginx, PHP, WordPress
Файл проходить усі ліміти, спрацьовує найменший
Директива Де діє Типове значення Що обмежує
Maximum Upload Size Cloudflare 100 МБ (Free, Pro), 200 МБ (Business) розмір запиту через проксі
client_max_body_size Nginx 1m тіло запиту
LimitRequestBody Apache 1 ГіБ (з версії 2.4.54, раніше без ліміту) тіло запиту
SecRequestBodyLimit ModSecurity 13107200 байт (12,5 МБ) у рекомендованому конфігу тіло запиту
post_max_size PHP 8M усі POST-дані разом
upload_max_filesize PHP 2M один файл
max_file_uploads PHP 20 кількість файлів в одному запиті
memory_limit PHP 128M пам’ять скрипта
max_execution_time / max_input_time PHP 30 с / 60 с (php.ini-production) час виконання і час отримання даних

Правило, яке рятує від більшості помилок: client_max_body_size ≥ post_max_size > upload_max_filesize. post_max_size має бути трохи більшим за upload_max_filesize, бо в POST-запиті, крім файлу, є інші поля форми і службові межі multipart. Документація PHP також радить, щоб memory_limit був більшим за post_max_size.

У стандартних конфігах деяких панелей хостингу Nginx уже має client_max_body_size 1024m, тож на такому хостингу (якщо адміністратор не змінював шаблон) вузьким місцем зазвичай стають саме ліміти PHP.

Як перевірити поточні ліміти

Тестовий PHP-файл

Створіть у корені сайту файл limits-check.php, відкрийте його в браузері і одразу після перевірки видаліть: такі файли розкривають конфігурацію сервера.

<?php
header('Content-Type: text/plain');
echo 'upload_max_filesize: ' . ini_get('upload_max_filesize') . PHP_EOL;
echo 'post_max_size: ' . ini_get('post_max_size') . PHP_EOL;
echo 'memory_limit: ' . ini_get('memory_limit') . PHP_EOL;
echo 'max_execution_time: ' . ini_get('max_execution_time') . PHP_EOL;
echo 'php.ini: ' . php_ini_loaded_file() . PHP_EOL;
echo 'SAPI: ' . php_sapi_name() . PHP_EOL;

Рядок SAPI підкаже, який спосіб зміни лімітів спрацює: fpm-fcgi або cgi-fcgi означає PHP-FPM чи FastCGI (працює .user.ini), apache2handler означає модуль Apache (працює php_value у .htaccess), litespeed означає сервер LiteSpeed.

Здоров’я сайту у WordPress

В адмінці відкрийте «Інструменти → Здоров’я сайту → Інформація» і розгорніть розділ про обробку медіа (Media Handling). Там є поля Max size of post data allowed, Max size of an uploaded file, Max effective file size і Max number of files allowed. Останнє ефективне значення: це менше з upload_max_filesize і post_max_size, саме його WordPress показує під формою завантаження.

На VPS через консоль

# які файли налаштувань читає PHP-FPM (не CLI)
php-fpm8.3 -i | grep -E "Loaded Configuration|Scan this dir"

# ліміт у всіх підключених конфігах Nginx
sudo nginx -T 2>/dev/null | grep -n client_max_body_size

# чи не задано ліміт жорстко в пулі PHP-FPM
grep -rn "upload_max_filesize\|post_max_size" /etc/php/8.3/fpm/pool.d/

Команда php -i показує налаштування консольного PHP, а не вебсервера: у Debian і Ubuntu це різні файли, /etc/php/8.3/cli/php.ini і /etc/php/8.3/fpm/php.ini. Багато хто редагує не той файл і дивується, що нічого не змінилося.

Щоб перевірити, хто відсікає запит, надішліть тестовий файл через curl:

truncate -s 20M test.bin
curl -s -o /dev/null -w "%{http_code}\n" -X POST --data-binary @test.bin https://example.com/
# 413 - запит відкинув вебсервер або проксі
# 200, 404, 405 - вебсервер запит пропустив, шукайте ліміт у PHP

Як збільшити upload_max_filesize: 4 способи

upload_max_filesize і post_max_size мають режим PHP_INI_PERDIR. Це означає, що їх можна змінити в php.ini, .user.ini, .htaccess (лише для модуля Apache) або в пулі PHP-FPM, але не функцією ini_set() у коді сайту.

1. php.ini на VPS або виділеному сервері

Замість правки великого php.ini зручніше створити окремий файл у теці conf.d: його легко знайти, і він не губиться серед сотень рядків.

; /etc/php/8.3/fpm/conf.d/99-uploads.ini
upload_max_filesize = 64M
post_max_size = 72M
memory_limit = 256M
max_execution_time = 300
max_input_time = 300
max_file_uploads = 20
sudo systemctl reload php8.3-fpm
# для Apache з mod_php
sudo systemctl reload apache2

Пишіть суфікси K, M, G без літери B. Значення 64MB PHP прочитає як 64 байти (починаючи з PHP 8.2 ще й з попередженням Invalid quantity), і завантаження перестануть працювати зовсім. Якщо в пулі PHP-FPM знайшовся рядок php_admin_value[upload_max_filesize], змініть його там: такі значення не перекриваються ні ini_set(), ні .user.ini.

2. .user.ini на віртуальному хостингу

Якщо PHP працює через PHP-FPM або FastCGI (так влаштована більшість сучасних хостингів), створіть у корені сайту, наприклад у public_html, файл .user.ini:

; public_html/.user.ini
upload_max_filesize = 64M
post_max_size = 72M
max_execution_time = 300
max_input_time = 300
  • PHP шукає .user.ini від теки запущеного скрипта вгору до кореня сайту, тому файл у корені діє на весь сайт.
  • Файл перечитується раз на 300 секунд (директива user_ini.cache_ttl), тож результат може з’явитися лише через 5 хвилин.
  • Для модуля Apache (mod_php) .user.ini не працює, там потрібен файл .htaccess.
  • Якщо хостер задав значення через php_admin_value, .user.ini їх не змінить: пишіть у підтримку.

3. .htaccess для Apache з mod_php або LiteSpeed

# .htaccess
<IfModule mod_php.c>
php_value upload_max_filesize 64M
php_value post_max_size 72M
php_value max_execution_time 300
php_value max_input_time 300
</IfModule>

Без обгортки IfModule директива php_value на сервері з PHP-FPM спричинить помилку 500 на хостингу: Apache не знає такої команди і пише в лог «Invalid command ‘php_value’». З обгорткою рядки просто ігноруються, якщо модуля немає. Сервер LiteSpeed теж розуміє php_value у .htaccess.

4. Через панель керування хостингом

У багатьох панелях змінити php.ini може лише адміністратор сервера в налаштуваннях сервера. Звичайний користувач на віртуальному хостингу доступу до цього розділу не має, тому для нього робочий шлях .user.ini або звернення до підтримки. У cPanel для цього є MultiPHP INI Editor. Порівняння можливостей різних панелей є в огляді панелей керування хостингом.

Як виправити 413 у Nginx: client_max_body_size

Директиву можна задати в блоках http (для всіх сайтів), server (для одного сайту) або location (для конкретної адреси). Значення нижчого рівня перекриває вищий.

# /etc/nginx/nginx.conf - для всіх сайтів
http {
    client_max_body_size 80m;
}

# або лише для одного сайту
server {
    server_name example.com;
    client_max_body_size 80m;
}
sudo nginx -t && sudo systemctl reload nginx

Одиниці в Nginx: k, m, g (регістр не важливий). Значення 0 вимикає перевірку зовсім, але на публічному сервері краще мати скінченний ліміт. Підтвердження, що відсікає саме Nginx, шукайте в error.log (детальніше про те, де лежать журнали, у статті про логи хостингу):

sudo grep "too large body" /var/log/nginx/error.log | tail -5
# client intended to send too large body: 52428800 bytes, client: 203.0.113.10,
# server: example.com, request: "POST /wp-admin/async-upload.php HTTP/2.0"

Apache: LimitRequestBody

Якщо Nginx працює як проксі перед Apache, ліміт мають пропускати обидва. В Apache з версії 2.4.54 типовий LimitRequestBody дорівнює 1 ГіБ, у старіших версіях обмеження не було. Значення вказується в байтах:

# VirtualHost або .htaccess: 100 МБ
LimitRequestBody 104857600

Cloudflare і ModSecurity

Станом на вересень 2026 року Cloudflare приймає через проксі запити до 100 МБ на тарифах Free і Pro та до 200 МБ на Business, для Enterprise ліміт вищий і налаштовується. Підняти його на безкоштовному тарифі не можна. Варіанти: завантажувати великі файли через SFTP, ділити їх на частини або використовувати окремий піддомен з режимом DNS only (без проксі) для адмінки. ModSecurity у рекомендованій конфігурації обмежує тіло запиту 13107200 байтами, тобто 12,5 МБ. На віртуальному хостингу цей ліміт змінює лише хостер.

WordPress: чому ліміт не змінюється

WordPress визначає максимальний розмір файлу функцією wp_max_upload_size(), яка бере менше з upload_max_filesize і post_max_size. Самостійно обійти ліміти сервера він не може, тому більшість «рецептів» з інтернету не працюють:

  • ini_set(‘upload_max_filesize’, ’64M’) у wp-config.php або functions.php нічого не дає: для директив PHP_INI_PERDIR ini_set() не діє.
  • WP_MEMORY_LIMIT змінює лише ліміт пам’яті WordPress, а не розмір файлу.
  • Плагіни для збільшення ліміту не обходять сервер: вони або змінюють лише число в інтерфейсі через фільтр upload_size_limit, або дописують ті самі .htaccess і .user.ini.
  • Мультисайт має власне обмеження: «Мережа → Налаштування → Max upload file size», типово 1500 КБ. Воно діє поверх лімітів PHP.
  • Завантаження теми чи плагіна з повідомленням «The link you followed has expired» майже завжди означає перевищення post_max_size.

Якщо «HTTP error» з’являється лише на великих фото, причиною може бути не розмір, а обробка зображення: створення мініатюр потребує пам’яті, тож варто перевірити memory_limit. Підсумковий чекліст:

Чекліст правильної зміни upload_max_filesize, post_max_size і client_max_body_size

Як завантажити великий файл без зміни лімітів

Ліміти PHP і Nginx стосуються лише завантаження через браузер. Великі відео, архіви чи дампи бази простіше передати іншим шляхом:

  • SFTP або FTP не залежать від налаштувань PHP. Завантажте файл, а потім зареєструйте його в медіабібліотеці через WP-CLI.
  • Дамп бази імпортуйте консольним клієнтом MySQL, а не через phpMyAdmin.
  • Каталог UploadDir у phpMyAdmin: якщо в конфігурації задано $cfg[‘UploadDir’], файли з цієї теки на сервері з’являються у списку для імпорту без завантаження через браузер.
  • Поділ архіву на частини допоможе, коли файл впирається в ліміт Cloudflare.
# додати в медіабібліотеку файл, уже завантажений через SFTP
wp media import ~/upload/video.mp4 --title="Презентація"

# імпорт стиснутого дампу бази без phpMyAdmin
gunzip < backup.sql.gz | mysql -u dbuser -p dbname

# поділити архів на частини по 90 МБ і зібрати назад
split -b 90M site.tar.gz part_
cat part_* > site.tar.gz

Покроково перенесення великої бази описано в статті про міграцію бази даних при переїзді хостингу. Якщо ж файл завантажився, але не з’явився на сайті, перевірте права доступу до файлів на теку uploads: PHP має право записувати в неї та в тимчасову теку.

Буває, що розмір уже не проблема, але великий файл вантажиться довго і завершується помилкою 504. Тоді справа в часі: потрібно узгодити max_input_time, client_body_timeout і тайм-аути проксі. Де налаштовуються ці тайм-аути і як їх узгодити, ми розбирали в статті про помилку 504. Якщо ж замість 504 сайт повертає 502, причини описано в статті про те, коли хостинг повертає 502.

Часті питання

Яке значення upload_max_filesize поставити?

Трохи більше за найбільший файл, який реально завантажують через браузер. Для блогу чи магазину на WordPress зазвичай достатньо 32-64M. Для відео й резервних копій краще використати SFTP, ніж піднімати ліміт до сотень мегабайт.

Чому після зміни .user.ini ліміт не змінився?

Найчастіші причини: не минуло 5 хвилин кешу user_ini.cache_ttl, файл лежить не в корені сайту, PHP працює як модуль Apache або хостер зафіксував значення через php_admin_value. Перевірте результат тестовим файлом з ini_get().

Чому після php_value у .htaccess сайт видає помилку 500?

PHP працює через PHP-FPM, і Apache не розуміє директиви php_value. Видаліть ці рядки або загорніть їх у <IfModule mod_php.c>, а ліміти задайте в .user.ini.

Чим upload_max_filesize відрізняється від post_max_size?

upload_max_filesize обмежує кожен окремий файл, post_max_size: увесь POST-запит разом з усіма файлами і полями. Якщо завантажуєте кілька файлів за раз, post_max_size має вміщати їх сумарний розмір.

Чи можна вказати client_max_body_size 0?

Можна, це вимикає перевірку розміру в Nginx. Але тоді будь-хто може надсилати на сервер запити довільного розміру, тому краще задати конкретне значення, не менше за post_max_size.

Чи впливає memory_limit на завантаження файлів?

Сам файл PHP записує в тимчасову теку, а не тримає в пам’яті, тому напряму memory_limit розмір не обмежує. Проте обробка зображень і розпакування архівів потребують пам’яті, а документація PHP радить тримати memory_limit більшим за post_max_size.

Висновок

Спочатку з’ясуйте, хто відхиляє файл: 413 означає Nginx, Apache, Cloudflare чи WAF, а повідомлення про upload_max_filesize або порожній $_POST означає PHP. Далі підніміть ліміт у правильному місці, дотримуючись співвідношення client_max_body_size ≥ post_max_size > upload_max_filesize, і перевірте результат через ini_get() або «Здоров’я сайту». Для дуже великих файлів надійніше використовувати SFTP і WP-CLI.

На тарифах віртуального хостингу RichHost сайти працюють на NVMe-дисках, керування йде через власну панель керування з ШІ-помічником, а SSL від Let’s Encrypt безкоштовний. Якщо вам потрібен майданчик під WordPress, перегляньте окремо хостинг для WordPress.

Ще за темою

Усі статті
Помилка 503 Service Unavailable: що означає і як виправити
Вирішення проблем хостингу13.10.2026

Помилка 503 Service Unavailable: що означає і як виправити

Що означає помилка 503 Service Unavailable, як за текстом сторінки і заголовками знайти її джерело та виправити: режим обслуговування WordPress, PHP-FPM, ліміти…

Error establishing a database connection у WordPress: як виправити
WordPress-хостинг21.09.2026

Error establishing a database connection у WordPress: як виправити

Що означає помилка Error establishing a database connection у WordPress, як за 5 кроків знайти причину і виправити wp-config.php, MySQL, пошкоджені таблиці…

ERR_TOO_MANY_REDIRECTS: причини і як виправити петлю переспрямувань
Вирішення проблем хостингу17.09.2026

ERR_TOO_MANY_REDIRECTS: причини і як виправити петлю переспрямувань

Що означає ERR_TOO_MANY_REDIRECTS і як за кілька хвилин знайти петлю переспрямувань. Покрокові рішення для Cloudflare, WordPress, .htaccess, Nginx і панелі хостингу.