3.9 KiB
Анализатор медиа
Раздел Медиа → Анализатор проверяет содержимое /uploads и сопоставляет
файлы с явными ссылками в документах, полях, рубриках, шаблонах, блоках,
навигации, запросах, настройках, теме и установленных модулях.
Проверка работает только на чтение. Она не удаляет, не переименовывает и не пережимает файлы.
После проверки AVE.cms обновляет компактную карту использования для карточек,
а также индекс имён и путей для глобального поиска. При удалении система не
доверяет возрасту этой карты и отдельно проверяет выбранный путь по живым данным.
Запускайте анализатор после массовой загрузки по FTP или восстановления копии
/uploads. Обычная загрузка и переименование через панель обновляют поисковый
индекс сразу.
Что показывает отчёт
| Группа | Что означает |
|---|---|
| Не используются | Явная ссылка на файл не найдена. Это кандидат на ручную проверку, а не команда на удаление. |
| Одинаковые | Несколько файлов имеют одинаковый размер и SHA-256 содержимого. |
| Нет оригиналов | В данных есть ссылка на отсутствующий файл либо служебное превью осталось без исходника. |
| Нет превью | Для изображения пока не найдено ни одной созданной миниатюры. При ленивой генерации это может быть нормой. |
| Большие | Файл не меньше 5 МБ либо сторона изображения не меньше 4000 px. |
| Неверные пути | Ссылка содержит недопустимый путь или ведёт за пределы /uploads. |
| Все файлы | Полная карта файлов, размеров, разрешений и найденных мест использования. |
Для каждого используемого файла выводится карта связей: тип сущности, её ID, поле или колонка и ссылка на подходящий раздел панели. Анализатор распознаёт литеральные пути. Если модуль собирает URL динамически из нескольких частей, файл может попасть в список «Не используются», поэтому удаление всегда выполняется только после ручной проверки.
Как пользоваться
- Откройте Медиа → Анализатор.
- Нажмите Запустить проверку.
- Начните с групп Нет оригиналов и Неверные пути.
- Проверьте дубли и крупные изображения.
- Перед удалением файла из группы Не используются откройте карту связей и проверьте публичный сайт.
Отчёт сохраняется в storage/reports/media-audit.json. Повторная проверка
полностью заменяет предыдущий отчёт актуальным состоянием.