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

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

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

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

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

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

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

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

--table=tablename 表明該遷移是用來(lái)對(duì) tablename 這張表進(jìn)行操作。

我們創(chuàng)建出來(lái)的遷移文件 create_user_table 會(huì)包含兩個(gè)方法。

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


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

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

假設(shè) user 表有 id,username,email 三個(gè)字段，那么可以再 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();
    });
}

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

我們操作的表是 user 表。

user 表中定義了 id 字段，因?yàn)檎{(diào)用了 increments 方法，所以 id 為 auto_increment，調(diào)用了 index 方法說(shuō)明給 id 添加了索引，最后 comment 等同于注釋。

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

email 字段 調(diào)用了 nullable 方法說(shuō)明運(yùn)行 email 字段為空。

定義字段結(jié)構(gòu)的時(shí)候可以使用鏈?zhǔn)秸{(diào)用的方式。

Laravel 中的方法是滿足你對(duì) sql 語(yǔ)句的所有操作，如果你需要定義一個(gè)類型為 text 的字段，那么可以調(diào)用 text() 方法，更多的方法說(shuō)明可以參見(jiàn)文檔 Laravel 數(shù)據(jù)庫(kù)結(jié)構(gòu)構(gòu)造器。

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

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

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

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

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

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

假設(shè)有表 user，我們需要對(duì)它重命名為 users。首先要執(zhí)行 php artisan make:migration rename_user_to_users --table user 來(lái)創(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 就就可以完成對(duì) user 表的重命名操作。如果需要回滾，只要執(zhí)行 php artisan migrate:rollback。

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

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

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

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

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

class UserTableSeeder extends Seeder
{

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

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

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

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

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

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

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

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

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

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

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

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

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

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

class UserTableSeeder extends Seeder
{

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

run 函數(shù)中這一波行云流水的鏈?zhǔn)秸{(diào)用在我剛剛開(kāi)始接觸 Laravel 的時(shí)候也是一臉黑線，不過(guò)習(xí)慣之后感覺(jué)這代碼可讀性確實(shí)很強(qiáng)

factory(AppUser::class) 指明返回哪個(gè)工廠，參數(shù) AppUser::class 就是工廠的唯一標(biāo)識(shí)。這里我們?cè)诙x工廠的時(shí)候 define 的第一個(gè)參數(shù)已經(jīng)指明了。

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

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

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

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