Как установить лимит на загрузку файлов в WooCommerce

Почему важно ограничивать размер загружаемых файлов в WooCommerce

В WooCommerce товары с загрузками (например, цифровые продукты, документы, изображения) требуют контроля размера файлов для предотвращения переполнения сервера и снижения производительности. Без ограничения пользователи могут загрузить слишком большие файлы, что приведет к ошибкам и дополнительным нагрузкам.

Диагностика проблем с загрузкой больших файлов в WooCommerce

Если при попытке загрузки файла в заказах WooCommerce появляется ошибка, или загрузка прекращается без уведомления, вероятно, превышен лимит размера файла.

• Ошибка PHP: POST Content-Length exceeded или upload_max_filesize в логах.
• Страница загрузки перезагружается без сохранения файла.
• В админке WooCommerce отображается сообщение об ошибке загрузки.

Первым шагом проверьте текущие настройки PHP, которые влияют на загрузку файлов:

upload_max_filesize = ?
post_max_size = ?
max_execution_time = ?

Для этого создайте в корне сайта файл phpinfo.php с содержимым:

<?php
phpinfo();
?>

И откройте его в браузере, чтобы увидеть значения параметров.

Пошаговое решение: ограничиваем размер загружаемых файлов в WooCommerce

1. Настройка PHP

Измените параметры в php.ini или добавьте в .htaccess (если хостинг поддерживает):

upload_max_filesize = 10M
post_max_size = 12M
max_execution_time = 300

Значения можно увеличить или уменьшить, исходя из требований. Например, 10 мегабайт — часто достаточный лимит для загрузок в WooCommerce.

2. Ограничение на уровне WooCommerce

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

Добавьте следующий код в файл functions.php вашей темы или в кастомный плагин:

add_filter('woocommerce_process_product_file_upload', 'limit_woocommerce_file_upload_size', 10, 3);

function limit_woocommerce_file_upload_size($file, $product_id, $upload_dir) {
    $max_size = 10 * 1024 * 1024; // 10 МБ
    if ($file['size'] > $max_size) {
        wc_add_notice(sprintf('Файл %s превышает допустимый размер 10 МБ.', $file['name']), 'error');
        return false; // Отклоняем загрузку
    }
    return $file;
}

Этот фильтр проверяет размер каждого файла и отменяет загрузку при превышении лимита.

3. Настройка ограничений в WooCommerce (для пользователей с фронтенда)

Если в вашем магазине используется загрузка файлов через форму заказа (например, для кастомных товаров), добавьте проверку в обработчик формы:

add_action('woocommerce_checkout_process', 'check_uploaded_files_size');
function check_uploaded_files_size() {
    $max_size = 10 * 1024 * 1024; // 10 МБ
    if (!empty($_FILES['custom_upload']) && $_FILES['custom_upload']['size'] > $max_size) {
        wc_add_notice('Загружаемый файл слишком большой. Максимальный размер 10 МБ.', 'error');
    }
}

Как проверить, что лимит применился и работает

• Попробуйте загрузить файл размером более 10 МБ — должна появиться ошибка WooCommerce с сообщением о превышении лимита.
• При загрузке файла менее 10 МБ загрузка должна пройти успешно без ошибок.
• Проверьте логи сервера на предмет ошибок PHP, связанных с загрузкой файлов.

Частые ошибки и их исправление при установке лимита на загрузку файлов в WooCommerce

• Ошибка 413 Request Entity Too Large — сервер отказал из-за слишком большого размера POST-запроса. Решение: увеличить post_max_size и upload_max_filesize в PHP и, если используется, в настройках веб-сервера (nginx/apache).
• Лимит не срабатывает, файлы больше разрешённого загружаются — возможно, фильтр применяется не к тому хуку или тема/плагин перезаписывают обработку. Проверьте приоритет фильтров и совместимость плагинов.
• Файлы не загружаются вообще — проверьте права на папку загрузок, а также ограничения сервера по времени выполнения скрипта (max_execution_time).

Практические советы по безопасности и производительности

• Всегда проверяйте типы загружаемых файлов — разрешайте только те форматы, которые нужны, чтобы избежать загрузки вредоносных скриптов.
• Используйте серверные ограничения PHP и веб-сервера в связке с проверками в WordPress для максимальной надежности.
• Для больших файлов используйте отдельные решения (например, CDN или облачные хранилища) и интеграцию с WooCommerce через API.

Сравнение способов ограничения размера файлов