數(shù)據(jù)庫 ―― 遷移

數(shù)據(jù)庫 —— 遷移

1、簡介

遷移，遷移通常和Laravel的結(jié)構(gòu)構(gòu)建器結(jié)對(duì)從而可以很容易地構(gòu)建應(yīng)用的數(shù)據(jù)庫表結(jié)構(gòu)。

Laravel的Schema門面提供了與數(shù)據(jù)庫系統(tǒng)無關(guān)的創(chuàng)建和操縱表的支持，在Laravel所支持的所有數(shù)據(jù)庫系統(tǒng)中提供一致的、優(yōu)雅的、平滑的API。

2、生成遷移

使用Artisan命令make:migration來創(chuàng)建一個(gè)新的遷移：

php artisan make:migration create_users_table

新的遷移位于database/migrations目錄下，每個(gè)遷移文件名都包含時(shí)間戳從而允許Laravel判斷其順序。

--table和--create選項(xiàng)可以用于指定表名以及該遷移是否要?jiǎng)?chuàng)建一個(gè)新的數(shù)據(jù)表。這些選項(xiàng)只需要簡單放在上述遷移命令后面并指定表名：

php artisan make:migration add_votes_to_users_table --table=users
php artisan make:migration create_users_table --create=users

如果你想要指定生成遷移的自定義輸出路徑，在執(zhí)行make:migration命令時(shí)可以使用--path選項(xiàng)，提供的路徑應(yīng)該是相對(duì)于應(yīng)用根目錄的。

3、遷移結(jié)構(gòu)

遷移類包含了兩個(gè)方法：up和down。up方法用于新增表，列或者索引到數(shù)據(jù)庫，而down方法就是up方法的反操作，和up里的操作相反。

在這兩個(gè)方法中你都要用到Laravel的表結(jié)構(gòu)構(gòu)建器來創(chuàng)建和修改表，想要學(xué)習(xí)Schema構(gòu)建器的更多有用方法，可以查看其文檔。例如，讓我們先看看創(chuàng)建flights表的簡單示例：

<?php

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

class CreateFlightsTable extends Migration{
    /**
     * 運(yùn)行遷移
     *
     * @return void
     */
    public function up()
    {
        Schema::create('flights', function (Blueprint $table) {
            $table->increments('id');
            $table->string('name');
            $table->string('airline');
            $table->timestamps();
        });
    }

    /**
     * 撤銷遷移
     *
     * @return void
     */
    public function down()
    {
        Schema::drop('flights');
    }
}

4、運(yùn)行遷移

要運(yùn)行應(yīng)用中所有未執(zhí)行的遷移，可以使用Artisan命令的migrate方法。如果你正在使用Homestead虛擬機(jī)，應(yīng)該在你的虛擬機(jī)中運(yùn)行如下這條命令：

php artisan migrate

如果再運(yùn)行時(shí)遇到”class not found“的錯(cuò)誤提示，嘗試運(yùn)行composer dump-autoload命令然后重新運(yùn)行遷移命令。

在生產(chǎn)環(huán)境中強(qiáng)制運(yùn)行遷移

有些遷移操作是毀滅性的，這意味著它們可能造成數(shù)據(jù)的丟失，為了避免在生產(chǎn)環(huán)境數(shù)據(jù)庫中運(yùn)行這些命令，你將會(huì)在運(yùn)行這些命令之前被提示并確認(rèn)。想要強(qiáng)制運(yùn)行這些命令而不被提示，可以使用--force：

php artisan migrate --force

4.1 回滾遷移

想要回滾最新的一次遷移”操作“，可以使用rollback命令，注意這將會(huì)回滾最后一批運(yùn)行的遷移，可能包含多個(gè)遷移文件：

php artisan migrate:rollback

migrate:reset命令將會(huì)回滾所有的應(yīng)用遷移：

php artisan migrate:reset

4.1.1 在單個(gè)命令中回滾/遷移

migrate:refresh命令將會(huì)先回滾所有數(shù)據(jù)庫遷移，然后運(yùn)行migrate命令。這個(gè)命令可以有效的重建整個(gè)數(shù)據(jù)庫：

php artisan migrate:refresh
php artisan migrate:refresh --seed

5、編寫遷移

5.1?創(chuàng)建表

使用Schema門面上的create方法來創(chuàng)建新的數(shù)據(jù)表。create方法接收兩個(gè)參數(shù)，第一個(gè)是表名，第二個(gè)是獲取用于定義新表的Blueprint對(duì)象的閉包：

Schema::create('users', function ($table) {
    $table->increments('id');
});

當(dāng)然，創(chuàng)建新表的時(shí)候，可以使用表結(jié)構(gòu)構(gòu)建器中的任意列方法來定義數(shù)據(jù)表的列。

5.1.1 檢查表/列是否存在

你可以輕松地使用hasTable和hasColumn方法檢查表或列是否存在：

if (Schema::hasTable('users')) {
    //
}

if (Schema::hasColumn('users', 'email')) {
    //
}

5.1.2 連接&存儲(chǔ)引擎

如果你想要在一個(gè)數(shù)據(jù)庫連接上執(zhí)行表結(jié)構(gòu)操作，該數(shù)據(jù)庫連接并不是默認(rèn)數(shù)據(jù)庫連接，使用connection方法：

Schema::connection('foo')->create('users', function ($table) {
    $table->increments('id');
});

要設(shè)置表的存儲(chǔ)引擎，在表結(jié)構(gòu)構(gòu)建器上設(shè)置engine屬性：

Schema::create('users', function ($table) {
    $table->engine = 'InnoDB';
    $table->increments('id');
});

5.2 重命名/刪除表

要重命名一個(gè)已存在的數(shù)據(jù)表，使用rename方法：

Schema::rename($from, $to);

要?jiǎng)h除一個(gè)已存在的數(shù)據(jù)表，可以使用drop或dropIfExists方法：

Schema::drop('users');Schema::dropIfExists('users');

5.3 創(chuàng)建列

要更新一個(gè)已存在的表，使用Schema門面上的table方法，和create方法一樣，table方法接收兩個(gè)參數(shù)：表名和獲取用于添加列到表的Blueprint實(shí)例的閉包：

Schema::table('users', function ($table) {
    $table->string('email');
});

5.3.1 可用的列類型

當(dāng)然，表結(jié)構(gòu)構(gòu)建器包含一系列你可以用來構(gòu)建表的列類型：

5.3.2 列修改器

除了上面列出的列類型之外，在添加列的時(shí)候還可以使用一些其它列”修改器“，例如，要使列默認(rèn)為null，可以使用nullable方法：

Schema::table('users', function ($table) {
    $table->string('email')->nullable();
});

下面是所有可用的列修改器列表，該列表不包含索引修改器：

5.4 修改列

5.4.1 先決條件

在修改列之前，確保已經(jīng)將doctrine/dbal依賴添加到composer.json文件，Doctrine DBAL庫用于判斷列的當(dāng)前狀態(tài)并在需要時(shí)創(chuàng)建SQL查詢來對(duì)列進(jìn)行指定的調(diào)整。

5.4.2 更新列屬性

change方法允許你修改已存在的列為新的類型，或者修改列的屬性。例如，你可能想要增加string類型列的尺寸，讓我們將name列的尺寸從25增加到50：

Schema::table('users', function ($table) {
    $table->string('name', 50)->change();
});

我們還可以修改該列允許NULL值：

Schema::table('users', function ($table) {
    $table->string('name', 50)->nullable()->change();
});

5.4.3 重命名列

要重命名一個(gè)列，可以使用表結(jié)構(gòu)構(gòu)建器上的renameColumn方法，在重命名一個(gè)列之前，確保doctrine/dbal依賴已經(jīng)添加到composer.json文件：

Schema::table('users', function ($table) {
    $table->renameColumn('from', 'to');
});

注意：enum類型的列的重命名暫不支持。

5.5 刪除列

要?jiǎng)h除一個(gè)列，使用表結(jié)構(gòu)構(gòu)建器上的dropColumn方法：

Schema::table('users', function ($table) {
    $table->dropColumn('votes');
});

你可以傳遞列名數(shù)組到dropColumn方法從表中刪除多個(gè)列：

Schema::table('users', function ($table) {
    $table->dropColumn(['votes', 'avatar', 'location']);
});

注意：在從SQLite數(shù)據(jù)庫刪除列之前，需要添加doctrine/dbal依賴到composer.json文件并在終端中運(yùn)行composer update命令來安裝該庫。

5.6 創(chuàng)建索引

表結(jié)構(gòu)構(gòu)建器支持多種類型的索引，首先，讓我們看一個(gè)指定列值為唯一索引的例子。要?jiǎng)?chuàng)建索引，可以使用unique方法：

$table->string('email')->unique();

此外，你可以在定義列之后創(chuàng)建索引，例如：

$table->unique('email');

你甚至可以傳遞列名數(shù)組到索引方法來創(chuàng)建混合索引：

$table->index(['account_id', 'created_at']);

5.6.1 可用索引類型

5.7 刪除索引

要?jiǎng)h除索引，必須指定索引名。默認(rèn)情況下，Laravel自動(dòng)分配適當(dāng)?shù)拿Q給索引——簡單連接表名、列名和索引類型。下面是一些例子：

5.8?外鍵約束

Laravel還提供了創(chuàng)建外鍵約束的支持，用于在數(shù)據(jù)庫層面強(qiáng)制引用完整性。例如，我們?cè)?code>posts表中定義了一個(gè)引用users表的id列的user_id列：

Schema::table('posts', function ($table) {
    $table->integer('user_id')->unsigned();
    $table->foreign('user_id')->references('id')->on('users');
});

你還可以為約束的“on delete”和“on update”屬性指定期望的動(dòng)作：

$table->foreign('user_id')
      ->references('id')->on('users')
      ->onDelete('cascade');

要?jiǎng)h除一個(gè)外鍵，可以使用dropForeign方法。外鍵約束和索引使用同樣的命名規(guī)則——連接表名、外鍵名然后加上”_foreign”后綴：

$table->dropForeign('posts_user_id_foreign');