Migration

這裏會介紹如何在 Laravel 5 使用 Migration 管理資料庫

Migration 指令

建立 Migration

$ php artisan make:migration create_users_table --create="users"

Migration 建立之後的檔案會放在 database/migrations/2015_04_11_134630_create_users_table.php

Migration 檔案最前面的日期會依照你建立 Migration 的時間自動產生，所以每個人看到的檔名皆會不同在後面加了 --create 的參數可以告訴 Migration，我們要做建立 user 資料表的動作，檔案內容會像這樣：

<?php
// database/migrations/2015_04_11_134630_create_users_table.php

use Illuminate\Database\Schema\Blueprint;
use Illuminate\Database\Migrations\Migration;

class CreateUsersTable extends Migration {

    /**
     * Run the migrations.
     *
     * @return void
     */ㄒ
    public function up()
    {
        Schema::create('users', function(Blueprint $table)
        {
            $table->increments('id');
            $table->timestamp();
        });
    }

    /**
     * Reverse the migrations.
     *
     * @return void
     */
    public function down()
    {
        Schema::drop('users');
    }

}

異動資料表欄位資料

如果我們要在 users 資料表中加欄位（或是其他改變資料表結構），我們可以用這樣的指令去建立 Migration

$ php artisan make:migration add_email_to_users_table --table="users"

在後面加了 --table 的參數可以告訴 Migration，我們要做異動 user 資料表的動作，檔案內容會像這樣：

<?php
// database/migrations/2015_04_12_154720_add_email_to_users_table.php

use Illuminate\Database\Schema\Blueprint;
use Illuminate\Database\Migrations\Migration;

class AddEmailToUsersTable extends Migration {

    /**
     * Run the migrations.
     *
     * @return void
     */
    public function up()
    {
        Schema::table('users', function(Blueprint $table)
        {
          $table->string('email', 180);
        });
    }

    /**
     * Reverse the migrations.
     *
     * @return void
     */
    public function down()
    {
        Schema::table('users', function(Blueprint $table)
        {
          $table->dropColumn('email');
        });
    }

}

原先的建立資料表會用 Schema::create()，而異動資料表則會用 Schema::table() 去做異動

列出目前所有 Migration 狀態

$ php artisan migrate:status

執行 Migration

$ php artisan migrate

恢復上一版本的 Migration

$ php artisan migrate:rollback

清除所有版本的 Migration

$ php artisan migrate:reset

清除所有版本的 Migration 並重新執行

$ php artisan migrate:refresh

備註

欄位異動

若做欄位異動 Migration 後需要 rollback，若丟出例外錯誤時，則使用 composer 安裝 doctrine/dbal 後即可解決 rollback 的問題

$ composer require doctrine/dbal

安全性

在剛開始開發產品的時候，有時候資料表有做小小的修改或異動，為了圖方便，我們常常會使用 migrate:reset 或 migrate:refresh 去清空我們的資料，重建資料表。

但如果產品已經上線了，這個指令就會是一個非常危險的指令，企業產品最重要的資產就是資料，這個指令會導致所有的資料都被清除，所以請上線後小心謹慎去使用。

Migration (遷移)