Ошибка большого файла почти всегда возникает раньше бизнес-кода. `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 Largenginx/reverse proxy/CDNaccess/error log и effective config
200/redirect, но $_FILES пустPHP post_max_sizephpinfo/ini_get и Content-Length
UPLOAD_ERR_INI_SIZEPHP upload_max_filesize$_FILES[file][error]
UPLOAD_ERR_NO_TMP_DIR или CANT_WRITEвременный каталог/дискupload_tmp_dir, права, df/inodes
обрыв по времениproxy/PHP/client timeoutrequest 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.

Граничный тест показывает реальный максимум

  1. Загрузить разрешённый тип размером немного ниже продуктового лимита и проверить итоговый объект/checksum.
  2. Загрузить файл немного выше лимита: получить контролируемый 413 или JSON-ошибку, без заполнения диска.
  3. Повторить на медленном соединении и убедиться, что timeout объясним и загрузка может возобновиться, если это обещано.
  4. Отправить несколько файлов на границе max_file_uploads и проверить явный отказ лишних.
  5. Смоделировать нехватку места в тестовой среде: временный файл очищается, задача не висит.
  6. Для multipart оборвать одну часть, повторить её и завершить объект с правильным checksum.

Для диагностики подготовьте схему browser → CDN/ingress → nginx → PHP → storage, effective limits каждого слоя, HTTP-статус и безопасный request id. После исправления мониторьте 413, PHP upload error codes, свободное место и незавершённые multipart sessions — так рост допустимого размера не превращается в новый отказ сервера.

Проверенные источники