php-database-migration/php-database-migration

rake and mybatis SQL migration tool

Wednesday, January 31, 2018
by alwex
Repository
4 Watchers
65 Stars
6,862 Installations

PHP
0 Dependents
0 Suggesters
24 Forks
4 Open issues
42 Versions
17 % Grown

The README.md

PhpDbMigration - full PHP database migration tool

, _(*1)

, _(*2)

This is a full standalone PHP tool based on Symfony Console and inspired by the Rails database migration tool and MyBatis. It merges the functionality of the two tools and has been designed to be as flexible as possible., _(*3)

Usage

$ ./bin/migrate
Console Tool

Usage:
  command [options] [arguments]

Options:
  -h, --help            Display this help message
  -q, --quiet           Do not output any message
  -V, --version         Display this application version
      --ansi            Force ANSI output
      --no-ansi         Disable ANSI output
  -n, --no-interaction  Do not ask any interactive question
  -v|vv|vvv, --verbose  Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug

Available commands:
  help            Displays help for a command
  list            Lists commands
 migrate
  migrate:addenv  Initialise an environment to work with php db migrate
  migrate:create  Create a SQL migration
  migrate:down    Rollback all waiting migration down to [to] option if precised
  migrate:init    Create the changelog table on your environment database
  migrate:status  Display the current status of the specified environment
  migrate:up      Execute all waiting migration up to [to] option if precised

Installing it to your project

Just add it to your composer.json (don't forget to specify your bin directory) Warning, all migrate commands must be executed on your root folder like bin/migrate migrate:command..., _(*4)

{
    "name": "jdoe/testproject",
    "authors": [
        {
            "name": "Jhon DOE",
            "email": "jdoe@gmail.com"
        }
    ],
    "require": {
        "php-database-migration/php-database-migration" :"3.6.*"
    },
    "config": {
        "bin-dir": "bin"
    }
}

Adding an environment

The first thing to do before playing with SQL migrations is to add an environment, let's add the dev one., _(*5)

$ ./bin/migrate migrate:addenv

You will be prompted to answer a series of questions about your environment, and then a config file will be saved in ./.php-database-migration/environments/[env].yml., _(*6)

Initialization

Once the environment is added, you have to initialize it. This verifies that the database connection works, and creates a new database table for tracking the current database changes:, _(*7)

$ ./bin/migrate migrate:init [env]

Create a migration

It is time to create our first migration file., _(*8)

$ ./bin/migrate migrate:create

Migrations file are like this, _(*9)

-- // add table users
-- Migration SQL that makes the change goes here.
create table users (id integer, name text);
-- @UNDO
-- SQL to undo the change goes here.
drop table users;

List migrations

View all available migrations and their status., _(*10)

$ ./bin/migrate migrate:status [env]
+----------------+---------+------------------+--------------------+
| id             | version | applied at       | description        |
+----------------+---------+------------------+--------------------+
| 14679010838251 |         |                  | create table users |
+----------------+---------+------------------+--------------------+

Up and down

You can now up all the pending migrations. If you decide to down a migration, the last one will be downed alone to prevent mistakes. You will be asked to confirm the downgrade of your database before running the real SQL script., _(*11)

$ ./bin/migrate migrate:up [env]

You can mark migrations as applied without executing SQL (e.g. if you switched from another migration system), _(*12)

$ ./bin/migrate migrate:up [env] --changelog-only

For development purposes, it is also possible to up a single migration without taking care of the other ones:, _(*13)

$ ./bin/migrate migrate:up [env] --only=[migrationid]

or migrate to specific migration (it will run all migrations, including the specified migration), _(*14)

$ ./bin/migrate migrate:up [env] --to=[migrationid]

Same thing for down:, _(*15)

$ ./bin/migrate migrate:down [env] --only=[migrationid]

or, _(*16)

$ ./bin/migrate migrate:down [env] --to=[migrationid]

The Versions

31/01 2018

dev-feature-support-symfony-console-4.x

dev-feature-support-symfony-console-4.x https://github.com/alwex/php-database-migration

rake and mybatis SQL migration tool

library php-database-migration

rake and mybatis SQL migration tool

php-database-migration/php-database-migration

The README.md

PhpDbMigration - full PHP database migration tool

Usage

Installing it to your project

Adding an environment

Initialization

Create a migration

List migrations

Up and down

The Versions

dev-feature-support-symfony-console-4.x

The Requires

The Development Requires

by GUIDET Alexandre

dev-master

The Requires

The Development Requires

by GUIDET Alexandre

v3.7.1

The Requires

The Development Requires

by GUIDET Alexandre

dev-hotfix-3.7.1

The Requires

The Development Requires

by GUIDET Alexandre

v3.7.0

The Requires

The Development Requires

by GUIDET Alexandre

dev-release-3.7.0

The Requires

The Development Requires

by GUIDET Alexandre

v3.6.10

The Requires

The Development Requires

by GUIDET Alexandre

dev-chxj1992-db_charset_feature

The Requires

The Development Requires

by GUIDET Alexandre

v3.6.9

The Requires

The Development Requires

by GUIDET Alexandre

dev-feature-integration

The Requires

The Development Requires

by GUIDET Alexandre

dev-feature-projectpage

The Requires

The Development Requires

by GUIDET Alexandre

v3.6.8

The Requires

The Development Requires

by GUIDET Alexandre

v3.6.7

The Requires

The Development Requires

by GUIDET Alexandre

v3.6.6

The Requires

The Development Requires

by GUIDET Alexandre

v3.6.5

The Requires

The Development Requires

by GUIDET Alexandre

v3.6.4

The Requires

The Development Requires

by GUIDET Alexandre

v3.6.3

The Requires

The Development Requires