Увеличение допустимого размера загрузок в PHP: практическое руководство

Расширенные примеры и результаты

Пример 1. Проверка текущих лимитов через phpinfo() и скрипт

Создать файл info.php:

<?php
phpinfo();
?>

После открытия в браузере найти раздел “Core” (или “Resource Limits”). Результат (фрагмент):

Directive               Local Value   Master Value
upload_max_filesize     2M            2M
post_max_size           8M            8M
memory_limit            128M          128M
max_execution_time      30            30

Пояснение: Видны текущие значения. Чтобы изменить любое, нужно действовать одним из описанных методов.

Пример 2. Использование ini_set() для memory_limit с последующей проверкой

<?php
echo 'Начальный memory_limit: ' . ini_get('memory_limit') . PHP_EOL;
ini_set('memory_limit', '512M');
echo 'После ini_set: ' . ini_get('memory_limit') . PHP_EOL;
// Попытка изменить upload_max_filesize
ini_set('upload_max_filesize', '100M');
echo 'upload_max_filesize после ini_set: ' . ini_get('upload_max_filesize') . PHP_EOL;
?>

Начальный memory_limit: 128M
После ini_set: 512M
upload_max_filesize после ini_set: 2M

Пояснение: memory_limit изменился, а upload_max_filesize остался прежним, так как относится к PHP_INI_SYSTEM.

Пример 3. Настройка через .htaccess и проверка через заголовки

# Содержимое .htaccess
php_value upload_max_filesize 20M
php_value post_max_size 20M
php_value max_execution_time 60

Результат: При загрузке файла размером 15 МБ ошибок не возникает. Проверить через скрипт:

<?php
echo 'upload_max_filesize: ' . ini_get('upload_max_filesize') . PHP_EOL;
echo 'post_max_size: ' . ini_get('post_max_size') . PHP_EOL;
?>

upload_max_filesize: 20M
post_max_size: 20M

Пример 4. Совместная настройка Nginx + PHP-FPM

Конфигурационный файл Nginx (site.conf):

server {
    listen 80;
    server_name example.com;
    root /var/www/html;
    
    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }
    
    location ~ \.php$ {
        fastcgi_pass unix:/run/php/php8.1-fpm.sock;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }
    
    location /upload {
        client_max_body_size 200M;
        proxy_pass http://127.0.0.1:8080;
    }
}

Параллельно в php.ini (или .user.ini) установить post_max_size = 200M и upload_max_filesize = 200M. Результат: сервер Nginx пропускает тело запроса до 200 МБ, PHP принимает файлы до 200 МБ.

Пример 5. Использование .user.ini в поддиректории

Структура: /var/www/html/upload/.user.ini

upload_max_filesize = 100M
post_max_size = 100M
max_file_uploads = 20  (необязательно)

Проверка через скрипт в этой папке:

<?php
echo 'Лимиты в папке upload:' . PHP_EOL;
echo 'upload_max_filesize: ' . ini_get('upload_max_filesize') . PHP_EOL;
echo 'post_max_size: ' . ini_get('post_max_size') . PHP_EOL;
echo 'max_file_uploads: ' . ini_get('max_file_uploads') . PHP_EOL;
?>

Лимиты в папке upload:
upload_max_filesize: 100M
post_max_size: 100M
max_file_uploads: 20

При этом в корневой папке лимиты могут быть другими (если не заданы в .user.ini).

Пример 6. Обработка ошибок на стороне PHP и вывод полезного сообщения

<?php
$maxSize = ini_get('upload_max_filesize');
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    if ($_FILES['file']['error'] === UPLOAD_ERR_INI_SIZE) {
        echo "Файл превышает максимальный размер, установленный PHP: $maxSize";
    } elseif ($_FILES['file']['error'] === UPLOAD_ERR_FORM_SIZE) {
        echo "Файл превышает значение MAX_FILE_SIZE в форме.";
    } else {
        // обработка успешной загрузки
        move_uploaded_file($_FILES['file']['tmp_name'], 'uploads/' . $_FILES['file']['name']);
        echo "Файл загружен успешно.";
    }
}
?>
<form method="post" enctype="multipart/form-data">
    <input type="hidden" name="MAX_FILE_SIZE" value="2097152" /> <!-- 2 MB -->
    <input type="file" name="file" />
    <input type="submit" value="Загрузить" />
</form>

Результат: пользователь видит конкретную причину отказа, если файл слишком большой.

Пример 7. Настройка в Apache через httpd.conf (глобально для виртуального хоста)

<VirtualHost *:80>
    DocumentRoot "/var/www/site"
    ServerName site.local
    <Directory "/var/www/site">
        AllowOverride All
        Options Indexes FollowSymLinks
        Require all granted
        php_value upload_max_filesize 48M
        php_value post_max_size 48M
        php_value max_execution_time 180
    </Directory>
</VirtualHost>

Результат: для данного виртуального хоста устанавливаются лимиты, перезаписывая значения из php.ini.