Question

创建迁移脚本

生成一个迁移脚本框架

让我们从创建一个新的 Phinx 迁移脚本开始。使用 create 命令：

$ php vendor/bin/phinx create MyNewMigration

这将创建一个新的迁移脚本，格式是 YYYYMMDDHHMMSS_my_new_migration.php ，前14个字符是当前的timestamp，精确到秒。

如果你指定了多个脚本路径，将会提示你选择哪一个。

Phinx 自动创建的迁移脚本框架有一个方法：

<?php

use Phinx\Migration\AbstractMigration;

class MyNewMigration extends AbstractMigration
{
    /**
     * Change Method.
     *
     * Write your reversible migrations using this method.
     *
     * More information on writing migrations is available here:
     * http://docs.phinx.org/en/latest/migrations.html#the-abstractmigration-class
     *
     * The following commands can be used in this method and Phinx will
     * automatically reverse them when rolling back:
     *
     *    createTable
     *    renameTable
     *    addColumn
     *    renameColumn
     *    addIndex
     *    addForeignKey
     *
     * Remember to call "create()" or "update()" and NOT "save()" when working
     * with the Table class.
     */
    public function change()
    {

    }
}

所有迁移脚本都继承类 AbstractMigration 。这个类提供了迁移脚本的基本方法。迁移脚本可以通过很多方法改变你的数据库，比如创建新表、插入数据、增加索引和修改字段等等。

Change 方法

Phinx 0.2.0 介绍了一个新功能-逆迁移（回滚）。现在这个功能成为了脚本的默认方法。在这个方法中，你只需要定义 up 的逻辑，Phinx 可以在回滚的时候自动识别出如何down。比如：

<?php

use Phinx\Migration\AbstractMigration;

class CreateUserLoginsTable extends AbstractMigration
{
    /**
     * Change Method.
     *
     * More information on this method is available here:
     * http://docs.phinx.org/en/latest/migrations.html#the-change-method
     *
     * Uncomment this method if you would like to use it.
     */
    public function change()
    {
        // create the table
        $table = $this->table('user_logins');
        $table->addColumn('user_id', 'integer')
              ->addColumn('created', 'datetime')
              ->create();
    }

    /**
     * Migrate Up.
     */
    public function up()
    {

    }

    /**
     * Migrate Down.
     */
    public function down()
    {

    }
}

当执行这个迁移脚本，Phinx 将创建 user_logins 表，并且在回滚的时候自动删除该表。注意，当 change 方法存在的时候，up 和 down 方法会被自动忽略。如果你想用这些方法建议你创建另外一个迁移脚本。

当在 change() 方法中创建或者更新表的时候你必须使用 create() 或者 update() 方法。当使用 save() 方法时，Phinx无法识别是创建还是修改数据表。

Phinx只能回滚以下命令：

1. createTable

2. renameTable

3. addColumn

4. renameColumn

5. addIndex

6. addForeignKey

如果一个命令无法回滚，那 Phinx 会抛出 IrreversibleMigrationException 异常。

Up 方法

up方法会在Phinx执行迁移命令时自动执行，并且该脚本之前并没有执行过。你应该将修改数据库的方法写在这个方法里。

Down 方法

down方法会在Phinx执行回滚命令时自动执行，并且该脚本之前已经执行过迁移。你应该将回滚代码放在这个方法里。