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, завантаження впаде на першому ж кроці.

| Директива | Де діє | Типове значення | Що обмежує |
|---|---|---|---|
| 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. Підсумковий чекліст:

Як завантажити великий файл без зміни лімітів
Ліміти 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.



