avto-dev/data-migrations-laravel

Package for data migrations in laravel applications

, _(*1)

Миграция данных БД для Laravel

![PHP Version][badge_php_version] ![Coverage][badge_coverage] ![License][badge_license], _(*2)

Данный пакет добавляет в ваше Laravel-приложение функционал мигрирования данных БД., _(*3)

Install

Require this package with composer using the following command:, _(*4)

$ composer require avto-dev/data-migrations-laravel "^2.4"

Installed composer is required (how to install composer)., _(*5)

You need to fix the major version of package., _(*6)

Опубликуйте конфигурационный файл, при помощи которого вы можете переопределить имя таблицы в БД для хранения данных о миграциях, имя соединения и прочие настройки:, _(*7)

$ php ./artisan vendor:publish --provider="AvtoDev\\DataMigrationsLaravel\\ServiceProvider"

После чего отредактируйте файл ./config/data-migrations.php на своё усмотрение и завершите установку, выполнив команду:, _(*8)

$ php ./artisan data-migrate:install

Использование

Проблема, которую решает данный пакет - это отсутствие встроенного в Laravel механизма мигрирования "боевых" данных в ваше приложение (seeds это механизм заполнения фейковыми данными изначально, а миграции БД несут ответственность за схему и т.д., но не данные)., _(*9)

Для того, что бы лучше ознакомиться с "механикой" работы данного пакета рассмотрим следующую ситуацию - ваше приложение использует 2 подключения к различным БД (default и second_db), и вам необходимо в каждом из них в уже существующие таблицы добавить какие-либо данные., _(*10)

Для этого вам необходимо выполнить 2 команды:, _(*11)

$ ./artisan make:data-migration "Add some data into first table"
$ ./artisan make:data-migration --connection="second_db" "Add some data into second table"

После выполнения которых создадутся 2 файла:, _(*12)

• ./storage/data_migrations/2018_01_01_022000_add_some_data_into_first_table.sql
• ./storage/data_migrations/second_db/2018_01_01_022001_add_some_data_into_second_table.sql

Которые вы можете наполнить SQL-командами, производящими необходимые insert-ы и так далее (помните, что идеологически верно использовать их только для манипуляций с данными)., _(*13)

После этого вам достаточно выполнить:, _(*14)

$ ./artisan data-migrate

И данная команда произведёт поиск всех файлов (за исключением тех, чьи имена начинаются с точки) в директории ./storage/data_migrations (путь может быть переопределен в конфигурационном файле) и попытается их выполнить, если запись об их выполнении не будет обнаружена в таблице migrations_data (которая была создана командой data-migrate:install)., _(*15)

Особенности

При использовании данного пакета следует знать о следующих особенностях:, _(*16)

• Если в директории с файлами-миграциями данных ./storage/data_migrations создать новую директорию, и уже в ней разместить файл-миграцию - то имя этой директории будет использовано как имя подключения к БД (описанное в файле ./config/database.php), которое надо использовать для применения миграций, что в ней размещены;
• Для применения миграций используются специальные классы, реализующие интерфейс ExecutorContract. Вы можете создать свой, указав его полное имя в файле-конфигурации;
• Миграции могут быть упакованы с помощью gzip (gzip file.sql). При наличии установленного php-расширения zlib они распаковываются "на лету", главное чтоб имя файла миграции заканчивалось на .gz;
• Миграции не имеют механизма "отката" (rollback-ов).

Artisan-команды

После установки данного пакета вам станут доступны следующие команды:, _(*17)

Testing

For package testing we use phpunit framework and docker-ce + docker-compose as develop environment. So, just write into your terminal after repository cloning:, _(*18)

$ make build
$ make latest # or 'make lowest'
$ make test

Changes log

![Commits since latest release][badge_commits_since_release], _(*19)

Changes log can be found here., _(*20)

Support

![Issues][badge_pulls], _(*21)

If you will find any package errors, please, make an issue in current repository., _(*22)

License

This is open-sourced software licensed under the MIT License., _(*23)