rhubarbphp/scaffold-database-migrations

A stem implementation of Module.Migrations for database migrations

1.0.2 2018-10-10 16:28 UTC

Requires

• rhubarbphp/custard: *
• rhubarbphp/module-migrations: ^1.0
• rhubarbphp/module-stem: *
• rhubarbphp/rhubarb: ^1.5.9
• rhubarbphp/scaffold-application-settings: ^1.0

Requires (Dev)

• codeception/codeception: 2.3.*
• codeception/verify: ^1.0
• phpunit/phpunit: ^6.5
• rhubarbphp/module-migrations: *

Apache-2.0

• framework
• database
• php
• version
• migration
• script
• rhubarb

README

This scaffold is a stem-specific implementation of the Migrations module. It includes:

DatabaseMigrationsStateProvider which stores the local state of your application using Stem.

DataMigrationScript an implementation of MigrationScriptInterface with additional helper methods to perform common data migrations.

Registering your script

Scripts will not be ran unless they are registered. Scripts can be registered by calling registerMigrationScripts($scriptsArray) on MigrationsModule.

   MigrationsManager::getMigrationsManager()->registerMigrationScripts([
       SplitNameColumnScript::class,
       DeleteAllImagesScript::class,
       UpdatedGdprInfoScript::class
   ]);

Data Migration Scripts

DataMigrationScripts implement MigrationsScriptInterface and includes common migration types that can be called during execution of your script.

class ContactNameSplitting extends DataMigrationScript
{
        public function execute()
        {
            foreach (Image::all(new Equals('active', false)) as $image) {
                unlink($image->filePath);
                $image->delete();
            }
            
            try {
                $this->updateEnumOption(
                    User::class,
                    'status',
                    'on line',
                    'online'
                );
            } catch (\Rhubarb\Crown\Exceptions\ImplementationException $e) {
            }
        }
    
        public function version(): int
        {
            return 18;
        }

        public function priority(): int
        {
            return 10;
        }
}