Снэпшоты: создание контрольного снимка файлов

Снэпшот фиксирует состояние выбранной части файловой системы. В отличие от версии одного файла, снэпшот работает с деревом каталогов и предназначен для контроля комплексных изменений.

Как создать снэпшот

1. Откройте «Сервисы → Инспектор файлов → Снэпшоты».
2. Выберите разрешённый корень.
3. Укажите basePath — относительную папку внутри корня. Пустой путь означает весь выбранный корень.
4. При необходимости добавьте комментарий.
5. Если нужно сохранить не только метаданные, но и сами файлы, включите «Сохранять вместе с файлами (ZIP)».
6. Нажмите «Снять снэпшот».

[Скриншот 1: форма создания снэпшота с root, basePath, комментарием и ZIP]

Что фиксируется

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

Статусы

Создание выполняется пошагово, поэтому запись может находиться в разных состояниях:

• running — сбор структуры ещё выполняется;
• done — снэпшот готов;
• error — обработка завершилась ошибкой;
• archiving — создаётся ZIP;
• restoring — выполняется восстановление.

В таблице отображается приблизительный прогресс, текущая очередь, последний обработанный каталог/путь и итоговые количества элементов, файлов и байтов.

Автоматическая обработка

После создания снэпшота модуль регистрирует или использует агент File Inspector. Агент по шагам продолжает задачи, чтобы большой каталог не пришлось полностью обрабатывать одним долгим HTTP-запросом. На странице также есть кнопка «Шаги» для ручного продвижения задачи.

Какой basePath выбирать

Для повседневной работы лучше снимать конкретную область: local/templates/site, local/php_interface или папку собственного модуля. Снэпшот всего сайта создаёт намного больше элементов и требует больше времени и места.

[Скриншот 2: таблица снэпшотов с прогрессом и статусом done]