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

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

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

Пошаговое решение: удаляем файлы после отмены заказа без плагинов

1. Определяем событие отмены заказа

WooCommerce использует статусы заказов. Отмена заказа — это перевод заказа в статус cancelled или refunded. Для отслеживания событий используйте хук woocommerce_order_status_cancelled или woocommerce_order_status_refunded.

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

Если вы продаёте цифровые товары, ссылки на файлы хранятся как метаданные в _downloadable_files или в свойствах продуктов. Нужно собрать пути к файлам, чтобы удалить их.

3. Пишем функцию для удаления файлов по пути

function wpupload_delete_files_by_paths( array $file_paths ) {
    foreach ( $file_paths as $file ) {
        $full_path = ABSPATH . $file; // предполагается относительный путь от корня
        if ( file_exists( $full_path ) && is_writable( $full_path ) ) {
            unlink( $full_path );
        }
    }
}

4. Основная функция на хук отмены заказа

add_action( 'woocommerce_order_status_cancelled', 'wpupload_handle_order_cancelled' );
add_action( 'woocommerce_order_status_refunded', 'wpupload_handle_order_cancelled' );

function wpupload_handle_order_cancelled( $order_id ) {
    $order = wc_get_order( $order_id );
    if ( ! $order ) {
        return;
    }

    $files_to_delete = [];

    foreach ( $order->get_items() as $item_id => $item ) {
        $product = $item->get_product();
        if ( $product && $product->is_downloadable() ) {
            $downloads = $product->get_downloads();
            foreach ( $downloads as $download ) {
                $file_url = $download->get_file();
                $file_path = wpupload_convert_url_to_path( $file_url );
                if ( $file_path ) {
                    $files_to_delete[] = $file_path;
                }
            }
        }
    }

    wpupload_delete_files_by_paths( $files_to_delete );
}

function wpupload_convert_url_to_path( $url ) {
    // Преобразуем URL файла в путь на сервере
    $upload_dir = wp_upload_dir();
    if ( strpos( $url, $upload_dir['baseurl'] ) === 0 ) {
        $relative_path = str_replace( $upload_dir['baseurl'], '', $url );
        return $upload_dir['basedir'] . $relative_path;
    }
    return false;
}

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

• Создайте тестовый заказ с цифровым товаром и оплатите.
• Проверьте, что файлы доступны для скачивания.
• Отмените заказ в админке WooCommerce, изменив статус на «Отменён» или «Возвращён».
• Проверьте папку загрузок — файлы, связанные с заказом, должны быть удалены.
• Проверьте логи ошибок сервера на предмет ошибок удаления.

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

• Файлы не удаляются: Проверьте права на папку uploads и файлы. PHP-процесс должен иметь право на удаление (chmod 755/775 папок, 644 файлов).
• Путь к файлу неверный: Функция wpupload_convert_url_to_path должна корректно переводить URL в путь относительно wp-content/uploads. Проверьте, что ссылки действительно находятся в upload_dir.
• Файлы удаляются не те, что надо: Убедитесь, что вы удаляете только файлы, связанные с товарами из заказа, а не общие ресурсы.
• Удаление ломает доступ к другим заказам: Файлы должны быть уникальны для заказа. Если один файл используется в нескольких заказах, его удалять нельзя.

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

• Перед удалением файлов делайте их резервное копирование, если данные важны.
• Добавьте логирование удаления для отладки и аудита.
• Если файлов много, удаление лучше делать через WP-Cron или внешние задачи, чтобы не блокировать обработку статуса заказа.
• Проверяйте, что удаление файлов не повредит функционал восстановления заказов или повторных загрузок.
• Для защиты файлов используйте настройку htaccess или приватные URL с проверкой доступа.

Сравнение подходов: плагин vs код vs компромисс