摘要：什么是數據庫的遷移數據庫遷移實際上就是對數據庫庫表的結構變化做版本控制之前對數據庫庫表結構做修改的方式比較原始比如說對某張庫表新增了一個字段都是直接在庫表中執行的方式直接修改但是這么做有些弊端比如在開發階段你自己的庫表修改了還要把這句語句傳

數據庫遷移實際上就是對數據庫庫表的結構變化做版本控制,之前對數據庫庫表結構做修改的方式比較原始,比如說對某張庫表新增了一個字段,都是直接在庫表中執行alter table xxx add .. 的方式直接修改,但是這么做有些弊端,比如在開發階段,你自己的庫表修改了,還要把這句sql語句傳給別人再執行一遍,這在多人協同開發時不是一種好的方式.那有沒有一種方式能讓我們對數據庫 庫表的修改做一些簡單的版本控制,同時能讓其他人很方便的同步我們對數據庫的修改呢? 答案是我們可以使用Laravel 內置的Migrations .

其實Laravel對數據庫的版本管理主要包括兩部門: 數據庫結構的管理 和數據的管理.

數據庫結構的管理: 主要是對數據庫結構進行管理,比如新增了一張表,某張表增加了一個字段等等.

數據的管理: 這個主要是管理表中的數據,生成一些填充數據,解決我們開發調試時沒有測試數據的問題.

要記錄下我們對數據庫結構所做的更改,我們可以使用Laravel內置 Migrations.

下面我們就走個小例子,看看如果要在數據庫中新增一個庫表具體該怎么做:

Laravel要和我們的數據庫連接,首先要有個對應的數據庫,你可以在PHPMyAdmin或者navicat for mysql 等管理工具新建一張表:

CREATE DATABASE `laravel5`;

我們要使用Laravel管理數據庫,第一步當然是要能連接上數據庫,數據庫的連接配置信息是放在根目錄下的.env文件中,這里我連接的是本地的數據庫:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel5
DB_USERNAME=root
DB_PASSWORD=123456

如果我們是第一次使用Migrations,那就要先執行migrate:install命令來支持數據庫的遷移,進入到項目的根目錄,執行安裝命令:

php artisan migrate:install

這句話執行了以后,Laravel會在數據庫新建一張migrations表,用這張表來記錄我們每次對數據庫做的更改:

以上三步是我們在首次使用Migrations是需要做的,相當于初始化工作,以后每次的更改只需要做下面的工作,好,我們接著往下走.我們的目標是創建一張表,比如說就創建一張商品表goods,首先我們用artisan命令來創建一個對應的遷移文件:

php artisan make:migration create_goods_table --create=goods

執行信息如下:

Created Migration: 2017_03_05_214805_create_goods_table

這句話解釋一下, make:migration 是遷移命令,create_goods_table 是遷移文件的文件名,--create=goods是該命令攜帶的參數,意思是創建一張表,并且表名是goods,這句話執行完畢以后, 我們可以在databasemigrations目錄下看到多個一個文件:

我們首先看一下這個文件的結構,

increments("id");
            $table->timestamps();
        });
    }

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

解釋一下這個文件:

該文件包括兩個函數,up和down,up方法是當執行遷移動作時要執行的方法,down方法是在進行數據庫回滾的時候執行的方法,因此up和down是一對反方法,up要創建一張表,down就是要刪除一張表,同理,當up中是新增一個字段時,down方法就是刪除一個字段了.

我們再來看一下up方法中的內容

Schema::create("goods", function (Blueprint $table) {..}
這里調用Schema操作表的方法來創建表,第二個參數是一個閉包,$table可以用來定義數據庫表的結構:

$table->increments("id");
創建一個自增長的字段,字段名默認叫id,當然你也可以改成其他名字.

$table->timestamps();
這里會在表中創建created_at 和 updated_at 字段.

我們所需要的當然不止這么簡單,下面我們就增加一些我們需要的字段:

    public function up()
    {
        Schema::create("goods", function (Blueprint $table) {
            $table->increments("id");
            $table->integer("goods_sn"); //商品貨號
            $table->string("goods_name");//商品名
            $table->decimal("prize", 10, 2); //價格
            $table->timestamps();
        });
    }

up方法中新增了三個字段,關于更多的字段類型選擇以及字段修飾,可以去查看一下文檔:數據庫: 遷移
好了,要對數據庫做的更改都定義好了,下面就是真正的執行遷移工作了:

在執行遷移之前,還需要執行一個命令composer dump-autoload,這個命令的主要作用是讓 composer 更新 autoload_classmap 的內容,包含到我們新建的文件,具體可參考下這篇文章深入 Composer autoload

composer dump-autoload

然后執行

php artisan migrate

輸出結果為:

然后我們查看一下數據庫,發現goods 表生成了!

同理,如果你想在這個表中新增一個字段,可以從第四步到第六步再走一遍,只不過這次不再是創建表,但是流程是一樣的.

有時候我們想撤銷對數據庫做的修改,比如上面新增了一張表,我現在想刪除那張表怎么辦,這個時候就可以使用migrations的回滾rollback命令:

php artisan migrate:rollback

注意,這個命令并不是回滾所有的migrate操作,而是回滾你上一次的操作,如果你想執行所有的回滾,可以使用reset命令,執行后會按照遷移文件的時間排序執行所有文件的down方法;

php artisan migrate:reset

使用refresh命令,可以回滾所有的操作,然后再次執行所有的遷移,實際就是按照時間排序執行所有的down方法,然后再執行所有的up方法;

php artisan migrate:refresh

現在我們已經建立起了數據庫表的結構,但是現在表中并沒有測試數據,如何制造一些假數據方便我們測試呢?在Laravel中我們可以Seeder+Faker來填充假數據;

假設我們想對goods表填充一些數據.我們第一步要做的工作是先有一個對應于goods表的Seeder文件,讓我們通過命令生成一個:

php artisan make:seeder GoodsTableSeeder

執行完后會在databaseseeds 目錄下看到生成的GoodsTableSeeder文件:

可以看到,類中只有一個默認的run方法,這個run方法就是我們執行數據填充的地方.
2. 編輯Seeder文件:
2.1 簡單的數據填充
我們先嘗試著做一次最簡單的數據填充,直接使用DB類來插入一條數據,編輯run方法:
    public function run()
    {
        DB::table("goods")->insert([
            "goods_sn" => 10001,
            "goods_name" => "加多寶涼茶",
            "prize" => 3.5
        ]);
    }
現在說了半天數據并沒有進入數據庫啊!莫慌,就差最后一步了: 執行seed命令:
php artisan db:seed --class=GoodsTableSeeder
執行完之后,就會發現數據已經填充到數據庫了:

2.2 使用模型工廠進行批量填充
上面我們簡單插入了一條數據,但是明顯不過癮,如果我們想一次插入100條數據,總不能手寫100遍吧,這個問題我們可以使用模型工廠來解決:
當然,使用模型工廠之前,必須要有個對應于goods表的一個Model類,讓我們執行命令生成一個:
php artisan make:model ModelsGood
生成的Model類 Good:

模型工廠對應于databasefactories中的ModelFactory.php文件,在這個文件中,我們新增一段代碼:
$factory->define(AppModelsGood::class, function (FakerGenerator $faker) {
    return [
        "goods_sn" => $faker->numberBetween(10001,20000),
        "goods_name" =>$faker->name, 
        "prize" => $faker->numberBetween(20,50)
    ];
});
define 方法中第一個參數表示關聯Good模型類,第二個參數傳入的是$faker,Faker是一個開源類庫,主要用于生成一些測試數據,比如電話號碼,人名,IP地址等等,這里Laravel內置了Faker,因此可以直接使用.
在方法中,對應于每個必須的字段,填充上對應的值;
然后回到GoodsTableSeeder.php文件,編輯run方法:
    public function run()
    {
        factory(Good::class)->times(10)->create(); //create()表示插入數據庫中
        //factory(Good::class)->times(10)->make(); //make()表示只生成對象,不插入庫表中
    }
這里調用factory方法,times表示要執行的次數.之后執行命令:
php artisan db:seed --class=GoodsTableSeeder
執行完畢之后,就會發現數據表中新增了十條數據.
2.4 單次執行全部seeder

上面的操作雖然可以完成對一張表批量插入多條數據,但是如果我有多個表都要進來批量插入數據,難道要執行多次db:seed xxx,當然不用這樣,databaseseeds目錄下有個DatabaseSeeder.php文件,這個文件的作用就是對多個seeder進行管理的,在這里可以調用其他的字Seeder類,指定他們的執行順序:
call(UsersTableSeeder::class);
        $this->call(StatusesTableSeeder::class);
        $this->call(RolesTableSeeder::class);
        $this->call(AdminUsersTableSeeder::class);
        Model::reguard();

    }
}

然后我們再執行seed命令:
php artisan db:seed
這個命令的作用就是執行DatabaseSeeder 的run方法,因此只需要執行上面的命令,就可執行所有表的填充命令了!
其實還有個最為強大的命令:
php artisan migrate:refresh --seed
這個命令主要做了三件事:

執行所有的回滾,也就是migrations目錄下所有文件的down方法,執行的時候按照時間順序.

所有回滾執行完畢后,執行所有的遷移,也就是按照時間順序執行所有的up方法.

執行所有的數據填充,也就是執行DatabaseSeeder 中的run方法.如果在run方法中沒有調用其他的seeder,則這個seeder的run方法不會被執行.