摘要：本文首發(fā)于作者這是一篇基礎教程，對標文檔中的數(shù)據(jù)遷移和數(shù)據(jù)填充。那么，中的數(shù)據(jù)庫遷移概念，就是用于解決團隊中保證數(shù)據(jù)庫結構一致的方案。和不同，如果多次執(zhí)行就會進行多次數(shù)據(jù)填充。好了，數(shù)據(jù)遷移和數(shù)據(jù)填充的基本操作也就這些了。

本文首發(fā)于 https://jaychen.cc
作者 JayChen

這是一篇基礎教程，對標 Laravel 文檔中的數(shù)據(jù)遷移和數(shù)據(jù)填充。

Laravel 中提供了數(shù)據(jù)庫遷移的方式來管理數(shù)據(jù)庫，想象一個場景：在一個多人開發(fā)的項目中，你的同事修改了某個數(shù)據(jù)庫結構并修改了代碼，通過 git 你可以即時的同步同事修改的代碼，但是數(shù)據(jù)庫結構，你只能通過手工的方式來復制同事修改的 SQL 語句，執(zhí)行以保證數(shù)據(jù)庫的結構一致。那么，Laravel 中的數(shù)據(jù)庫遷移概念，就是用于解決團隊中保證數(shù)據(jù)庫結構一致的方案。

migration 使用非常簡單，編寫一定的 php 代碼并執(zhí)行，那么 Laravel 就會自動的更新數(shù)據(jù)庫。假設你的同事要修改數(shù)據(jù)庫某個字段，那么只要編寫 php 代碼，接著你通過 git 更新了代碼，執(zhí)行 migrate 操作之后，你的數(shù)據(jù)庫結構就和他的同步了。下面我們就來看具體的使用方法。

Laravel 把編寫數(shù)據(jù)庫改動的 php 代碼稱為遷移，可以通過 php artisan make:migration filename 的方式來創(chuàng)建遷移文件。假設你需要創(chuàng)建一張新的 user 表，那么你可以通過執(zhí)行 php artisan make:migration create_user_table --create=user 來創(chuàng)建一個遷移文件，執(zhí)行命令會在 database/migrations/ 目錄下建立一個 文件創(chuàng)建時間_filename 的 php 文件，那么這個文件就是我們接下來用來編寫數(shù)據(jù)庫結構變化的文件了。這里要提一點，雖然說創(chuàng)建遷移文件的名稱可以隨意，但是為了管理方便，最好文件名可以體現(xiàn)要執(zhí)行的數(shù)據(jù)庫操作，比如這里我們要創(chuàng)建一張 user 表，所以文件名稱為 create_user_table。

php artisan make:migration filename 有兩個可選參數(shù)

--create=tablename 表明該遷移是用來創(chuàng)建表。

--table=tablename 表明該遷移是用來對 tablename 這張表進行操作。

我們創(chuàng)建出來的遷移文件 create_user_table 會包含兩個方法。

public function up()
{
    Schema::create("user", function (Blueprint $table) {
        $table->increments("id");
        $table->timestamps();
    });
}


public function down()
{
    Schema::dropIfExists("user");
}

這兩個方法是互逆的操作，比如我們可以再 up 方法中編寫我們要創(chuàng)建的 user 表的相關信息，而 down 方法中則是刪除 user 表的操作。這樣，我們就可以做到回滾操作，當我們創(chuàng)建 user 表之后發(fā)現(xiàn)某個字段名寫錯了，就可以通過 down 來刪除 user 表，進而重新建立 user 表。

假設 user 表有 id,username,email 三個字段，那么可以再 up 方法中寫

public function up()
{
    Schema::create("user", function (Blueprint $table) {
        $table->increments("id")->index()->comment("用戶id");
        $table->string("name")->default("")->comment("用戶名");
        $table->string("email")->nullable()->comment("用戶郵箱");
        $table->timestamps();
    });
}

一般，我們的邏輯會在閉包函數(shù)中寫。上面的代碼，即時不能完全明白，也可以大概猜出以下幾點：

我們操作的表是 user 表。

user 表中定義了 id 字段，因為調用了 increments 方法，所以 id 為 auto_increment，調用了 index 方法說明給 id 添加了索引，最后 comment 等同于注釋。

有了 id 的經(jīng)驗，那么 name 字段也很好理解了，string 方法說明 name 是 varchar/char 類型的，default 定義了 name 字段的默認值。

email 字段 調用了 nullable 方法說明運行 email 字段為空。

定義字段結構的時候可以使用鏈式調用的方式。

Laravel 中的方法是滿足你對 sql 語句的所有操作，如果你需要定義一個類型為 text 的字段，那么可以調用 text() 方法，更多的方法說明可以參見文檔 Laravel 數(shù)據(jù)庫結構構造器。

我們已經(jīng)編寫好了 user 表的結構，接下來執(zhí)行 php artisan migrate，Laravel 會根據(jù) create 方法自動為我們創(chuàng)建 user 表。至此，我們已經(jīng)成功的通過 Larvel 的遷移功能來實現(xiàn)創(chuàng)建表。

使用 Laravel 的遷移功能可以有后悔藥吃。

執(zhí)行 php artisan migrate 創(chuàng)建 user 表之后，覺得不行，不要 user 這張表，于是你打算刪除這張表。那么這時候我們就要使用剛剛說到的 down 方法了。

public function down()
{
    Schema::dropIfExists("user");
}

這里 Laarvel 已經(jīng)為我們寫好邏輯了，dropIfExists 函數(shù)就是用來刪除表，我們只需要執(zhí)行 php artisan migrate :rollback 就可以回滾到執(zhí)行 php artisan migrate 之前的狀態(tài)。

除了創(chuàng)建表，也可以用遷移記錄表的其他任何操作，包括修改表屬性，修改字段等等操作。這里再舉個例子說明如何用遷移來對表進行重命名。

假設有表 user，我們需要對它重命名為 users。首先要執(zhí)行 php artisan make:migration rename_user_to_users --table user 來創(chuàng)建遷移文件。

在 up 方法中寫我們要重命名表的邏輯。

public function up()
{
    Schema::table("user", function (Blueprint $table) {
        Schema::rename("user","users");
    });
}

為了可以 rollback 可以順利執(zhí)行，我們還需要在 down 方法中編寫撤銷重命名操作的邏輯。

public function up()
{
    Schema::table("user", function (Blueprint $table) {
        //
        Schema::rename("users","user");
    });
}

最后執(zhí)行 php artisan migrate 就就可以完成對 user 表的重命名操作。如果需要回滾，只要執(zhí)行 php artisan migrate:rollback。

你會發(fā)現(xiàn)，如果執(zhí)行一次遷移之后，如果執(zhí)行第二次遷移是不會重復執(zhí)行的，這是因為 Laravel 會在數(shù)據(jù)庫中建立一張 migrations 的表來記錄哪些已經(jīng)進行過遷移。

基本的 migration 介紹就到這里，以上的內容可以應對大部分的需求，如果需要更詳細的介紹，可能需要閱讀 Laravel 那不知所云的文檔了。:)

Laravel 中除了 migration 之外，還有一個 seeder 的東西，這個東西用于做數(shù)據(jù)填充。假設項目開發(fā)中需要有一些測試數(shù)據(jù)，那么同樣可以通過編寫 php 代碼來填充測試數(shù)據(jù)，那么通過 git 同步代碼，所有的人都可以擁有一份同樣的測試數(shù)據(jù)。

同樣，數(shù)據(jù)填充在 Laravel 中被稱為 Seeder，如果需要對某張表填充數(shù)據(jù)，需要先建立一個 seeder。通過執(zhí)行 php artisan make:seeder UserTableSeeder 來生成一個 seeder 類。這里我們希望填充數(shù)據(jù)的表示 test 表，所以名字為 UserTableSeeder。當然這個名字不是強制性的，只是為了做到見名知意。

創(chuàng)建 UserTableSeeder 之后會在 database/seeders 目錄下生成一個 UserTableSeeder 類，這個類只有一個 run 方法。你可以在 run 方法中寫插入數(shù)據(jù)庫的代碼。假設我們使用 DB facade 來向 test 表插入數(shù)據(jù)。

class UserTableSeeder extends Seeder
{

    public function run()
    {
        DB::table("users")->insert($insertData);
    }
}

編寫完代碼之后，執(zhí)行 php artsian db:seeder --class= UserTableSeeder 來進行數(shù)據(jù)填充。執(zhí)行完畢之后查看數(shù)據(jù)庫已經(jīng)有數(shù)據(jù)了。

如果我們有多個表要進行數(shù)據(jù)填充，那么不可能在編寫完 php 代碼之后，逐個的執(zhí)行 php artisan db:seeder --class=xxxx 來進行填充。有一個簡便的方法。在 DatabaseSeeder 的 run 方法中添加一行 $this->call(UserTableSeeder::class);，然后執(zhí)行 php artisan db:seeder，那么 Laravel 就會執(zhí)行 DatabaseSeeder 中的 run 方法，然后逐個執(zhí)行遷移。

和 migration 不同，如果多次執(zhí)行 php artisan db:seeder 就會進行多次數(shù)據(jù)填充。

加入你想一次性插入大量的測試數(shù)據(jù) ，那么在 run 方法中使用 DB facade 來逐個插入顯然不是一個好的方法。Laravel 中提供了一種模型工廠的方式來創(chuàng)建創(chuàng)建大量的數(shù)據(jù)。

模型工廠，意味著本質其實是一個工廠模式。那么，在使用模型工廠創(chuàng)建數(shù)據(jù)需要做兩件事情

創(chuàng)建工廠，定義好工廠要返回的數(shù)據(jù)。

調用工廠獲取數(shù)據(jù)。

Laravel 中通過執(zhí)行 php artisan make:factory UserFactory --model=User 來為 User Model 創(chuàng)建一個工廠類，該文件會放在 database/factory 目錄下。打開該文件可以看到如下代碼：

$factory->define(AppUser::class, function (Faker $faker) {
    return [
        //
    ];
});

這里， return 的值就是我們第 2 步調用工廠獲取到的數(shù)據(jù)。生成數(shù)據(jù)的邏輯也只需要寫在閉包函數(shù)中就可以。這里需要提一下 Faker 這個類。這是一個第三方庫，Laravel 集成了這個第三方庫。這個庫的作用很好玩：用于生成假數(shù)據(jù)。假設 User 表需要插入 100 個用戶，那么就需要 100 個 username，那么你就不必自己寫邏輯生成大量的 test01，test02 這樣子幼稚的假數(shù)據(jù)，直接使用 Faker 類，會替你生成大量逼真的 username。(我也不知道這個算不算無聊了 :)。。。)。

現(xiàn)在假設 User 表有 id, email, username 三個字段，那么我要生成 100 個用戶，首先在工廠類中實現(xiàn)邏輯。

$factory->define(AppModelsUser::class, function (Faker $faker) {
    return [
        // 直接調用 faker API 生成假數(shù)據(jù)，更多 faker 相關查看 文檔。
        "username" => $faker->name,
        "email" => $faker->unique()->safeEmail,
    ];
});

現(xiàn)在，我們已經(jīng)定義好了工廠，現(xiàn)在我們就要在 UserSeeder@run 函數(shù)中使用模型工廠來生成測試數(shù)據(jù)。

class UserTableSeeder extends Seeder
{

    public function run()
    {
        factory(AppUser::class)->times(10)->make()->each(function($user,$index){
            $user->save();
        });
    }
}

run 函數(shù)中這一波行云流水的鏈式調用在我剛剛開始接觸 Laravel 的時候也是一臉黑線，不過習慣之后感覺這代碼可讀性確實很強

factory(AppUser::class) 指明返回哪個工廠，參數(shù) AppUser::class 就是工廠的唯一標識。這里我們在定義工廠的時候 define 的第一個參數(shù)已經(jīng)指明了。

->times(10) 指明需要工廠模式生成 10 個 User 數(shù)據(jù)。即會調用 10 次 define 函數(shù)的第二個參數(shù)。

->make() 把生成的 10 個 User 數(shù)據(jù)封裝成 Laravel 中的集合對象。

->each() 是 Laravel 集合中的函數(shù)，each 函數(shù)會針對集合中的每個元素進行操作。這里直接把數(shù)據(jù)保存到數(shù)據(jù)庫。

好了，數(shù)據(jù)遷移和數(shù)據(jù)填充的基本操作也就這些了。更多復雜的用法。。。。也不一定能用上。