Подключение модуля необходимо проводить находясь в DOCUMENT_ROOT проекта:
composer require worksolutions/bitrix-reduce-migrations
Команда перенесет файлы модуля в папку /bitrix/modules/ws.reducemigrations
Следующим шагом будет регистрация в битрикс:
composer run-script post-install-cmd -d bitrix/modules/ws.reducemigrations
Результатом регистрации будут следующие пункты:
- Модуль будет зарегистрирован в системе;
- Будет создан каталог
reducemigrationsв папке на уровне bitrix; - В каталог bitrix/admin переносится файл-контроллер модуля. Для работы модуля через административный интерфейс.
- Появится файл
bitrix/tools/migrateдля работы миграций через командную строку.
Также регистрацию модуля можно запустить через страницу "Установленные решения":
http://my-site.ru/bitrix/admin/partner_modules.php?lang=ru
Для установки в адресную строку браузера, после доменного имени, прописать:
/bitrix/admin/update_system_partner.php?addmodule=ws.reducemigrations
К примеру:
http://my-site.ru/bitrix/admin/update_system_partner.php?addmodule=ws.reducemigrations
При установке модуля необходимо определить основные параметры.
Для успешной работы модуля необходимо определить каталог, где будут создаваться файлы синхронизации данных. Каталог сделать должен синхронизироваться системой версионирования проекта.
После установки модуля в настройках можно изменить путь к каталогу, в котором будут храниться миграции
Если на проекте использовалась первая версия модуля, то желательно для нового модуля настроить другой каталог хранения файлов миграций. Это исключит путаницу связанную с одинаковыми по назначению, но не по реализации, модулями. Конечно при этом все члены команды должны осознавать то, что они работают с новой версией миграций данных.
Таким образом переход к новому модулю можно осуществить в два этапа:
- Установить параллельно новый модуль;
- Через время удалить неиспользуемый, в тот момент, когда полностью налажена работа с новым модулем.