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

本文首發于 https://jaychen.cc
作者 JayChen

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

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

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

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

php artisan make:migration filename 有兩個可選參數

--create=tablename 表明該遷移是用來創建表。

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

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

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


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

這兩個方法是互逆的操作，比如我們可以再 up 方法中編寫我們要創建的 user 表的相關信息，而 down 方法中則是刪除 user 表的操作。這樣，我們就可以做到回滾操作，當我們創建 user 表之后發現某個字段名寫錯了，就可以通過 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();
    });
}

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

我們操作的表是 user 表。

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

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

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

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

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

我們已經編寫好了 user 表的結構，接下來執行 php artisan migrate，Laravel 會根據 create 方法自動為我們創建 user 表。至此，我們已經成功的通過 Larvel 的遷移功能來實現創建表。

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

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

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

這里 Laarvel 已經為我們寫好邏輯了，dropIfExists 函數就是用來刪除表，我們只需要執行 php artisan migrate :rollback 就可以回滾到執行 php artisan migrate 之前的狀態。

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

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

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

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

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

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

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

你會發現，如果執行一次遷移之后，如果執行第二次遷移是不會重復執行的，這是因為 Laravel 會在數據庫中建立一張 migrations 的表來記錄哪些已經進行過遷移。

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

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

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

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

class UserTableSeeder extends Seeder
{

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

編寫完代碼之后，執行 php artsian db:seeder --class= UserTableSeeder 來進行數據填充。執行完畢之后查看數據庫已經有數據了。

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

和 migration 不同，如果多次執行 php artisan db:seeder 就會進行多次數據填充。

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

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

創建工廠，定義好工廠要返回的數據。

調用工廠獲取數據。

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

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

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

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

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

現在，我們已經定義好了工廠，現在我們就要在 UserSeeder@run 函數中使用模型工廠來生成測試數據。

class UserTableSeeder extends Seeder
{

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

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

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

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

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

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

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