Автоматическое удаление файлов WooCommerce после отмены заказа без плагинов

Диагностика проблемы: почему файлы остаются после отмены заказа в WooCommerce

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

Как автоматически удалить файлы после отмены заказа в WooCommerce: пошаговое решение

1. Используем хук для отслеживания смены статуса заказа

В WooCommerce есть хук woocommerce_order_status_changed, который позволяет реагировать на смену статуса заказа. Нам нужно отследить переход в статус cancelled (отменён).

2. Получаем связанные с заказом загруженные файлы

Чаще всего пользовательские файлы могут храниться как метаполя заказа или в метаполях товаров. В примере рассмотрим, что файлы хранятся в метаполе заказа _uploaded_files в виде массива путей или URL.

3. Удаляем файлы с диска и очищаем метаполя

Для удаления используем функции из WP Filesystem API, чтобы гарантировать совместимость с разными файловыми системами.

Пример кода для functions.php или кастомного плагина

add_action('woocommerce_order_status_changed', 'wpupload_delete_files_on_cancel', 10, 4);function wpupload_delete_files_on_cancel($order_id, $old_status, $new_status, $order) {    if ($new_status !== 'cancelled') {        return;    }    $uploaded_files = get_post_meta($order_id, '_uploaded_files', true);    if (empty($uploaded_files) || !is_array($uploaded_files)) {        return;    }    global $wp_filesystem;    if ( ! $wp_filesystem ) {        require_once ABSPATH . '/wp-admin/includes/file.php';        WP_Filesystem();    }    foreach ($uploaded_files as $file_path) {        // Преобразуем URL в путь относительно корня сервера        $upload_dir = wp_upload_dir();        $relative_path = str_replace($upload_dir['baseurl'], $upload_dir['basedir'], $file_path);        if ($wp_filesystem->exists($relative_path)) {            $wp_filesystem->delete($relative_path);        }    }    // Удаляем метаполе после очистки    delete_post_meta($order_id, '_uploaded_files');}

Проверка результата после внедрения

• Создайте тестовый заказ с загруженными файлами, убедитесь, что в заказе в метаполе _uploaded_files содержатся корректные пути.
• Отмените заказ через админку WooCommerce.
• Проверьте, что файлы физически удалены из папки uploads и метаполе очищено.
• Просмотрите лог ошибок сервера на предмет возможных ошибок при удалении.

Частые ошибки и как их исправить

• Файлы не удаляются, хотя код срабатывает: проверьте, что пути к файлам правильные и существуют. Важно правильно конвертировать URL в путь файловой системы.
• Отсутствует инициализация WP_Filesystem: вызов WP_Filesystem() обязателен для работы с API файлов.
• Метаполе хранится не в заказе, а в товарах: тогда нужно адаптировать код для обхода товаров в заказе и удаления файлов оттуда.
• Права доступа к файлам запрещают удаление: убедитесь, что веб-сервер имеет права на запись и удаление в папке uploads.

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

• Всегда проверяйте, что удаляемые файлы находятся внутри папки uploads — исключите удаление системных файлов.
• Если заказ содержит много файлов, подумайте о запуске удаления через очередь или wp_cron, чтобы не нагружать страницу и не вызывать тайм-ауты.
• Логируйте удаление файлов для последующего аудита и отладки.
• Резервное копирование данных перед массовыми удалениями обязательно.

Сравнение подходов удаления файлов WooCommerce после отмены заказа