Ошибка большого файла почти всегда возникает раньше бизнес-кода. `413` обычно возвращает proxy, пустые `$_POST` и `$_FILES` при превышении тела указывают на `post_max_size`, а `UPLOAD_ERR_INI_SIZE` — на `upload_max_filesize`. Начните с HTTP-статуса, response headers и error code, а не с увеличения всех чисел до гигабайта.
Продуктовый предел должен оставаться конечным. Он защищает диск, worker и канал от случайной или злонамеренной загрузки. Сначала решите, какой максимальный размер и число файлов реально нужны, затем настройте каждый слой с небольшим запасом на multipart-поля и возвращайте пользователю понятную ошибку до долгой передачи.
Где именно остановился запрос
| Симптом | Вероятный слой | Где подтвердить |
|---|---|---|
| 413 Request Entity Too Large | nginx/reverse proxy/CDN | access/error log и effective config |
| 200/redirect, но $_FILES пуст | PHP post_max_size | phpinfo/ini_get и Content-Length |
| UPLOAD_ERR_INI_SIZE | PHP upload_max_filesize | $_FILES[file][error] |
| UPLOAD_ERR_NO_TMP_DIR или CANT_WRITE | временный каталог/диск | upload_tmp_dir, права, df/inodes |
| обрыв по времени | proxy/PHP/client timeout | request time, upstream status, сеть |
| один из многих файлов пропал | max_file_uploads | количество полей и PHP config |
Запишите `Content-Length`, если он известен, request id и момент отказа. Не сохраняйте содержимое файла в журнал. Для chunked transfer размер заранее может быть неизвестен, поэтому сервер всё равно обязан считать принятые байты и прекращать превышение безопасным статусом.
Лимиты должны образовать понятную лестницу
# nginx: ограничение на уровне location загрузки
location /api/uploads/ {
client_max_body_size 55m;
proxy_pass http://php_app;
}
; php.ini / pool config
upload_max_filesize = 50M
post_max_size = 55M
max_file_uploads = 10
upload_tmp_dir = /var/lib/php/uploadsДокументация nginx указывает: превышение `client_max_body_size` возвращает 413. В PHP `post_max_size` должен быть больше `upload_max_filesize`, потому что тело содержит границы multipart и другие поля. Значения в примере условны: выберите свои и проверьте effective конфигурацию того PHP-FPM pool, который обслуживает запрос, а не CLI `php -i`.
- Ограничьте большой размер только upload-route, а не каждый POST сайта.
- Проверьте лимит ingress/CDN/load balancer перед nginx: приложение не может увеличить внешний потолок.
- После изменения проверьте конфигурацию и выполняйте управляемый reload, не прерывая текущие запросы.
- Убедитесь, что временный и конечный разделы имеют свободные байты и inode.
- Считайте размер на сервере повторно: значение MAX_FILE_SIZE из HTML — лишь удобство для пользователя.
Принятый файл ещё нельзя считать безопасным
После успешной передачи приложение проверяет код `UPLOAD_ERR_*`, фактический размер, разрешённый тип и содержимое. Имя от пользователя не становится путём на диске. Файл получает случайный object key, хранится вне исполняемой web-директории и проходит антивирусную/форматную проверку до публикации.
if (!isset($_FILES['document'])) throw new RuntimeException('upload_missing');
$file = $_FILES['document'];
if ($file['error'] !== UPLOAD_ERR_OK) throw new UploadException($file['error']);
if ($file['size'] > 50 * 1024 * 1024) throw new DomainException('file_too_large');
$mime = (new finfo(FILEINFO_MIME_TYPE))->file($file['tmp_name']);
if (!in_array($mime, ['application/pdf', 'image/jpeg'], true)) {
throw new DomainException('unsupported_type');
}
// object key генерируется сервером; исходное имя хранится только как metadata.Не доверяйте `$_FILES[type]`: его присылает клиент. Если обработчик конвертирует изображения или распаковывает архив, добавьте отдельные пределы на пиксели, число записей и распакованный объём. Иначе небольшой архив может занять весь диск после приёма.
Для видео и архивов лучше не вести весь поток через PHP
Presigned URL позволяет браузеру загрузить объект напрямую в storage с временным ограниченным правом, а приложение выдаёт ключ и после загрузки подтверждает metadata/checksum. Для нестабильной сети multipart upload делит объект на части: неудачную часть можно повторить без повторной передачи всего файла. AWS рекомендует multipart как практику для объектов от 100 MB, но порог проекта зависит от сети и SDK.
| Схема | Подходит | Что контролировать |
|---|---|---|
| один POST через приложение | малые документы | proxy/PHP limits, temp disk |
| presigned single PUT | средний объект | key, expiry, content type, checksum |
| multipart upload | крупный объект/плохая сеть | upload id, parts, complete/abort |
| background import по URL | доверенный источник | SSRF-защита, size/time limits |
Presigned URL не должен позволять произвольный key или бессрочную запись. AWS также предупреждает: загрузка по существующему key заменяет объект. Генерируйте новый key сервером, ограничивайте срок/права, сверяйте checksum и удаляйте незавершённые multipart uploads политикой lifecycle.
Граничный тест показывает реальный максимум
- Загрузить разрешённый тип размером немного ниже продуктового лимита и проверить итоговый объект/checksum.
- Загрузить файл немного выше лимита: получить контролируемый 413 или JSON-ошибку, без заполнения диска.
- Повторить на медленном соединении и убедиться, что timeout объясним и загрузка может возобновиться, если это обещано.
- Отправить несколько файлов на границе max_file_uploads и проверить явный отказ лишних.
- Смоделировать нехватку места в тестовой среде: временный файл очищается, задача не висит.
- Для multipart оборвать одну часть, повторить её и завершить объект с правильным checksum.
Для диагностики подготовьте схему browser → CDN/ingress → nginx → PHP → storage, effective limits каждого слоя, HTTP-статус и безопасный request id. После исправления мониторьте 413, PHP upload error codes, свободное место и незавершённые multipart sessions — так рост допустимого размера не превращается в новый отказ сервера.