Очистка кэша изображений по размеру для OpenCart 3

⭐ Коротко о главном

Модуль точечной очистки кэша изображений для OpenCart 3.
Позволяет удалять из папок кэша только те файлы, которые были сгенерированы под конкретные размеры (ширину × высоту), не затрагивая оригиналы и остальной кэш.

Больше не нужно вручную лазить по FTP и вычищать десятки тысяч ненужных миниатюр, или удалять весь кэш целиком и ждать, пока магазин снова его сгенерирует.

⚙️ Зачем это нужно

Каждый раз, когда OpenCart отображает товар, категорию или баннер — он создаёт кэшированное изображение нужного размера. Файлы складываются в image/cache/... и имеют имя вида product-200x200.jpg, banner-750x300.jpg.

Со временем:
    - Вы поменяли размер миниатюры в настройках магазина → старые кэши (например, 200×200) остались мёртвым грузом.
    - Обновили тему — у неё другие размеры картинок → все предыдущие кэши не используются, но лежат на диске.
    - Сменили шаблон категорий → старые баннерные размеры больше не генерируются, но занимают место.
    - Установили новый модуль с собственными размерами → старый кэш никому не нужен.

Результат: папка image/cache разрастается до гигабайт, забивает диск, замедляет бэкапы и увеличивает время синхронизации.

Раньше единственным решением было:
    - Удалить всю папку cache — но тогда магазин тормозит неделю, пока всё не перегенерируется.
    - Ходить по FTP и вручную чистить папки.

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

✔️ Что умеет модуль

Гибкая настройка папок кэша для очистки

Через удобный интерфейс с кнопкой (+) добавляйте любое количество папок относительно image/:
    cache
    cache/catalog
    cache/catalog/demo
    cache/home
    cachewebp
    thumb

    и любые другие — сколько нужно.

Удаление проходит рекурсивно по всем вложенным подпапкам.

Несколько размеров одновременно:

Тоже через (+) — добавляйте сколько угодно пар «ширина × высота»:
    200 × 200
    500 × 500
    750 × 300
    1000 × 1000

Один клик — и из выбранных папок удаляются все файлы, попадающие под эти размеры.

Предпросмотр перед удалением

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

✖️ Кнопка «УДАЛИТЬ КЭШ ВЫБРАННОГО РАЗМЕРА»

Массовое удаление одним нажатием. После операции выводится подробный отчёт:
    Удалено файлов: 247 (200x200 — 189, 500x500 — 58)

♻️ Очистка пустых папок

После массового удаления в кэше остаются пустые директории. Отдельная кнопка «Очистить пустые папки» убирает их рекурсивно — папка cache снова выглядит чистой.

Логирование

Каждое удаление записывается в лог system/storage/logs/imagecachecleaner.log:
    дата и время,
    ID пользователя,
    размеры, по которым чистили,
    количество удалённых файлов,
    полный список путей удалённых файлов.

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

⚠️ Безопасность — в приоритете

Защита от дурака

Модуль не позволит удалить содержимое критических папок:
    catalog (и любые вложенные) — игнорируется
    image (корень) — игнорируется
    пустое значение — игнорируется

При попытке указать такую папку выводится предупреждение — модуль просто пропустит её и сообщит, что и почему.

Оригиналы не трогаются

Удаляются только файлы кэша — те, чьё имя заканчивается на -ШИРИНАxВЫСОТА.расширение (как их формирует сам OpenCart). Оригинальные изображения товаров, категорий, баннеров остаются на месте, даже если они лежат в тех же папках.

Защита от path traversal

Запросы с .. или нулевыми байтами в пути отбрасываются — нельзя выйти за пределы папки image.

Права доступа

Модуль работает только для пользователей с правом modify на него.

✏️ Интерфейс

    Все действия — в один клик, из стандартной админки OpenCart 3.

    Настройки сохраняются в штатной таблице oc_setting — ничего лишнего в базе.

    Внешний вид полностью соответствует стилю админки OpenCart.

    Работает на любых сборках: OpenCart 3.x, ocStore 3.x, кастомные сборки на базе OC3.

☝️ Кому будет полезен

    Владельцам магазинов с большим каталогом — экономия дискового пространства.

    Разработчикам и студиям — при смене темы, шаблонов, размеров картинок.

    Администраторам — при регулярном техобслуживании магазина.

    Всем, кто устал от растущей папки image/cache и не хочет удалять её целиком.

▶️ Установка

    Загрузите файлы модуля на сервер (или установите .ocmod.zip через Установщик расширений).

    Расширения → Модули → найдите «Очистка кэша изображений по размеру» → нажмите зелёный (+).

    Редактировать → добавьте папки и размеры → сохраните.

    Готово. Пользуйтесь кнопками Предпросмотр, УДАЛИТЬ, Очистить пустые папки.

★ Технические характеристики

    Совместимость: OpenCart 3.0.x, ocStore 3.0.x

    Языки: русский, английский

    База: использует только oc_setting

    Зависимости: нет

    Безопасность: защита от path traversal, whitelist расширений изображений, проверка прав

    Логирование: system/storage/logs/imagecachecleaner.log

v103
Добавлена возможность указать сразу несколько размеров для удаления из кэша

v102
Добавлено:
- логирование удалённых файлов в файл;
- кнопку «Очистить пустые папки» после удаления;
- предпросмотр (сколько файлов будет удалено) до фактического удаления.

v101
Предварительная версия

Написать

Ваше Имя:


Ваш отзыв: Внимание: HTML не поддерживается! Используйте обычный текст.

Оценка: Плохо           Хорошо

Введите код, указанный на картинке:

Файлы будут доступны после покупки