Определение порога размера для отправляемых файлов

Расширенные примеры настройки и отладки

Пример 1. Проверка и обработка ошибок при загрузке файла

Код ниже демонстрирует, как проанализировать коды ошибок из массива $_FILES и дать пользователю понятное сообщение.

// form.php
<form action="upload.php" method="post" enctype="multipart/form-data">
    <input type="hidden" name="MAX_FILE_SIZE" value="2097152" /> <!-- 2 MB -->
    <input type="file" name="userfile" />
    <input type="submit" value="Загрузить" />
</form>

// upload.php
$allowed_errors = [
    UPLOAD_ERR_OK         => 'Файл загружен успешно.',
    UPLOAD_ERR_INI_SIZE   => 'Размер файла превышает значение upload_max_filesize.',
    UPLOAD_ERR_FORM_SIZE  => 'Размер файла превышает значение MAX_FILE_SIZE в форме.',
    UPLOAD_ERR_PARTIAL    => 'Файл загружен частично.',
    UPLOAD_ERR_NO_FILE    => 'Файл не был выбран.',
    UPLOAD_ERR_NO_TMP_DIR => 'Отсутствует временная папка.',
    UPLOAD_ERR_CANT_WRITE => 'Ошибка записи на диск.',
    UPLOAD_ERR_EXTENSION  => 'Загрузка остановлена расширением.',
];

if ($_SERVER['REQUEST_METHOD'] === 'POST' && isset($_FILES['userfile'])) {
    $error_code = $_FILES['userfile']['error'];
    echo $allowed_errors[$error_code] ?? 'Неизвестная ошибка.';
    if ($error_code === UPLOAD_ERR_OK) {
        echo ' Имя файла: ' . $_FILES['userfile']['name'];
    }
}

В случае, если файл превышает upload_max_filesize, пользователь увидит: «Размер файла превышает значение upload_max_filesize.»

Пример 2. Проверка текущих лимитов с помощью phpinfo()

Для быстрой диагностики можно создать скрипт, выводящий значения всех релевантных директив.

<?
phpinfo(INFO_CONFIGURATION);
?>

После запуска скрипта ищите разделы Core и найдите параметры: upload_max_filesize, post_max_size, max_execution_time, memory_limit. Также обратите внимание на max_file_uploads – максимальное количество файлов, загружаемых за один запрос.

Пример 3. Расчёт необходимого memory_limit при обработке изображения

При загрузке изображения и его обработке (например, изменение размера с помощью GD) PHP загружает изображение в память целиком. Потребление памяти может быть в несколько раз больше размера файла.

// Допустим, загружается JPEG изображение размером 10 МБ.
// Для декодирования в несжатый формат (RGB) потребуется:
// ширина * высота * 3 байта (для 24-битного цвета).
// Если изображение 4000x3000 пикселей:
$memory_needed = 4000 * 3000 * 3; // 36 000 000 байт ≈ 34.3 MB
// Плюс накладные расходы PHP: memory_limit должен быть около 64-128M.
echo 'Расчётная необходимая память: ' . round($memory_needed / 1024 / 1024, 1) . ' MB';

Расчётная необходимая память: 34.3 MB

Пример 4. Обработка загрузки через поток (stream) без загрузки всего файла в память

Для больших файлов (более 100 MB) можно избежать увеличения memory_limit, читая файл частями. Однако это не влияет на лимиты приёма файла, а только на его обработку.

$inputStream = fopen('php://input', 'r');
$outputFile = fopen('/tmp/large_file.dat', 'w');
stream_copy_to_stream($inputStream, $outputFile);
fclose($inputStream);
fclose($outputFile);
echo 'Файл сохранён в потоке.';

Данный скрипт принимает тело POST-запроса (которое уже прошло проверку на upload_max_filesize и post_max_size) и записывает его напрямую в файл, не создавая временной копии в памяти. Однако такой подход требует отключения обработки multipart-форм (обычно используется для application/octet-stream).

Пример 5. Настройка nginx совместно с PHP-FPM для загрузки файлов до 100 MB

Конфигурация nginx (фрагмент):

server {
    listen 80;
    server_name example.com;
    client_max_body_size 100M;

    location /upload/ {
        proxy_pass http://127.0.0.1:9000;
        proxy_connect_timeout 300;
        proxy_send_timeout 300;
        proxy_read_timeout 300;
    }
}

Пул PHP-FPM (фрагмент):

php_value[upload_max_filesize] = 95M
php_value[post_max_size] = 100M
php_value[max_execution_time] = 600
php_value[max_input_time] = 600

Почему в PHP установлено 95M, а не 100M? Небольшой запас оставляется для учёта накладных расходов multipart-запроса. Тогда nginx пропустит запрос, а PHP успешно примет файл.

Пример 6. Использование .user.ini на разных уровнях каталогов

Файл .user.ini может располагаться не только в корне, но и в подкаталогах. Настройки применяются ко всем вложенным директориям, если не переопределены.

# /var/www/site/public/.user.ini
upload_max_filesize = 50M

# /var/www/site/public/admin/.user.ini
upload_max_filesize = 10M   ; для панели администратора лимит снижен

Такая иерархия удобна на сайтах с разными ролями пользователей.