「CakeDC Migrations Plugin」の導入

CakePHPのディレクトリに移動し、Composerでインストールします。

$ composer require "cakedc/migrations:~2.3"

./composer.json has been updated
Loading composer repositories with package information
Updating dependencies (including require-dev)           
  - Installing cakedc/migrations (2.4.0)
    Downloading: 100%         

Writing lock file
Generating autoload files

（Composerって処理遅いよね。ここでは5分程。ネット回線のせいかな）

インストールできました。

プラグインを読み込みます。

~/Config/bootstrap.php

<?php
// 56行目あたり
/**
 * Plugins need to be loaded manually, you can either load them one by one or all of them in a single call
 * Uncomment one of the lines below, as you need. Make sure you read the documentation on CakePlugin to use more
 * advanced ways of loading plugins
 *
 * CakePlugin::loadAll(); // Loads all plugins at once
 * CakePlugin::load('DebugKit'); //Loads a single plugin named DebugKit
 *
 */
CakePlugin::load('Migrations'); // この行を追加

これでおｋ。

マイグレーションファイルの作成

早速Pluginを使って、DBにテーブルを作成してみましょう。

$ ./Console/cake migrations:migration generate create_posts id:primary_key title:string body:text created modified
Error: Shell class Migrations:migrationShell could not be found.

（°ω°；

何故だ。

あ、ごめんなさい。誤字でした。migrations:migrationのところは「：」ではなく「.」でした。ごめんなさい。

修正して実行

$ ./Console/cake migrations.migration generate create_posts id:primary_key title:string body:text created modified

Cake Migration Shell
---------------------------------------------------------------
---------------------------------------------------------------
Generating migration from commandline arguments...
Do you want to preview the file before generation? (y/n) 
[y] > n
Generating Migration...

Done.

ヒアドキュメントで聞かれます。質問の内容は「プレビューしますか？」って内容らしいのでいいえ（n）でいきましょう。

マイグレーションファイルが作成されました。確認してみます。

~/Config/Migartion/xxxxxxxxxx_create_posts.php

<?php
class CreatePosts extends CakeMigration {

/**
 * Migration description
 *
 * @var string
 */
    public $description = 'create_posts';

/**
 * Actions to be performed
 *
 * @var array $migration
 */
    public $migration = array(
        'up' => array(
            'create_table' => array(
                'posts' => array(
                    'id' => array('type' => 'integer', 'null' => false, 'default' => null, 'key' => 'primary'),
                    'title' => array('type' => 'string', 'null' => false, 'default' => null),
                    'body' => array('type' => 'text', 'null' => false, 'default' => null),
                    'created' => array('type' => 'datetime', 'null' => false, 'default' => null),
                    'modified' => array('type' => 'datetime', 'null' => false, 'default' => null),
                    'indexes' => array(
                        'PRIMARY' => array('column' => 'id', 'unique' => true),
                    ),
                ),
            ),
        ),
        'down' => array(
            'drop_table' => array(
                'posts'
            ),
        ),
    );

/**
 * Before migration callback
 *
 * @param string $direction Direction of migration process (up or down)
 * @return bool Should process continue
 */
    public function before($direction) {
        return true;
    }

/**
 * After migration callback
 *
 * @param string $direction Direction of migration process (up or down)
 * @return bool Should process continue
 */
    public function after($direction) {
        return true;
    }
}

凄すぎてワロタ

いいね。これ。

マイグレーションの適用

作ったマイグレーションファイルを実行します。

$ ./Console/cake migrations.migration run all -d
Cake Migration Shell
---------------------------------------------------------------
Running migrations:

Migration will run dry, no database changes will be made

---------------------------------------------------------------
SQL for migration 1442625841_create_posts:
---------------------------------------------------------------
CREATE TABLE `test_test_test`.`posts` (`id` int(11) NOT NULL AUTO_INCREMENT,`title` varchar(255) NOT NULL,`body` text NOT NULL,`created` datetime NOT NULL,`modified` datetime NOT NULL,PRIMARY KEY  (`id`)) ;
---------------------------------------------------------------
All migrations have completed.

-dを付けて、実行すると実行すSQL文を確認すことができます。問題なければはずして実行しましょう。

$ ./Console/cake migrations.migration run all 
Cake Migration Shell
---------------------------------------------------------------
Running migrations:
  [1442625841] 1442625841_create_posts
An error occurred when processing the migration:
  Migration: 1442625841_create_posts
  Error: Table "posts" already exists in database.
---------------------------------------------------------------
Do you want to mark the migration as successful?. [y]es or [a]bort. (y/a) 
> a

おろ？

自分の環境では、どうやらすでにpostsテーブルが存在するっぽいです。

削除して再実行

$ ./Console/cake migrations.migration run all 
Cake Migration Shell
---------------------------------------------------------------
Running migrations:
  [1442625841] 1442625841_create_posts
      > Creating table "posts".

---------------------------------------------------------------
All migrations have completed.

おｋ

ちなみに、allではなく、downにすると前のバージョンに戻ります。便利！

$ ./Console/cake migrations.migration run down
Cake Migration Shell
---------------------------------------------------------------
Running migrations:
  [1442625841] 1442625841_create_posts
      > Dropping table "posts".

---------------------------------------------------------------
All migrations have completed.