簡介

所謂遷移就像是數(shù)據(jù)庫的版本控制，這種機制允許團隊簡單輕松的編輯并共享應用的數(shù)據(jù)庫表結構。遷移通常和 Laravel 的 schema 構建器結對從而可以很容易地構建應用的數(shù)據(jù)庫表結構。如果你曾經(jīng)頻繁告知團隊成員需要手動添加列到本地數(shù)據(jù)庫表結構以維護本地開發(fā)環(huán)境，那么這正是數(shù)據(jù)庫遷移所致力于解決的問題。

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

生成遷移

使用 Artisan 命令 make:migration 就可以創(chuàng)建一個新的遷移：

php artisan make:migration create_users_table

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

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

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

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

遷移結構

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

在這兩個方法中你都要用到 Laravel 的 Schema 構建器來創(chuàng)建和修改表，要了解更多 Schema 構建器提供的方法，查看其文檔。下面讓我們先看看創(chuàng)建 flights 表的簡單示例：

<?php

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

class CreateFlightsTable extends Migration
{
  /**
   * Run the migrations.
   *
   * @return void
   */
  public function up()
  {
    Schema::create('flights', function (Blueprint $table) {
      $table->increments('id');
      $table->string('name');
      $table->string('airline');
      $table->timestamps();
    });
  }

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

運行遷移

要運行應用中所有未執(zhí)行的遷移，可以使用 Artisan 命令提供的 migrate 方法：

php artisan migrate

注：如果你正在使用 Homestead 虛擬機，需要在虛擬機中運行上面這條命令。

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

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

php artisan migrate --force

回滾遷移

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

php artisan migrate:rollback

你也可以通過 rollback 命令上提供的 step 選項來回滾指定數(shù)目的遷移，例如，下面的命令將會回滾最后五條遷移：

php artisan migrate:rollback --step=5

migrate:reset 命令將會回滾所有的應用遷移：

php artisan migrate:reset

在單個命令中回滾 & 遷移

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

php artisan migrate:refresh

// 重建數(shù)據(jù)庫并填充數(shù)據(jù)...
php artisan migrate:refresh --seed

當然，你也可以回滾或重建指定數(shù)量的遷移 —— 通過 refresh 命令提供的 step 選項，例如，下面的命令將會回滾或重建最后五條遷移：

php artisan migrate:refresh --step=5

刪除所有表 & 遷移

migrate:fresh 命令將會先從數(shù)據(jù)庫中刪除所有表然后執(zhí)行 migrate 命令：

php artisan migrate:fresh

php artisan migrate:fresh --seed

數(shù)據(jù)表

創(chuàng)建表

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

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

當然，創(chuàng)建新表的時候，可以使用 Schema 構建器中的任意列方法來定義數(shù)據(jù)表的列。

檢查表/列是否存在

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

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

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

數(shù)據(jù)庫連接 & 表選項

如果你想要在一個數(shù)據(jù)庫連接上執(zhí)行表結構操作，而該數(shù)據(jù)庫連接并不是默認數(shù)據(jù)庫連接，可以使用 connection 方法：

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

要設置表的存儲引擎、字符編碼等選項，可以在 Schema 構建器上使用如下命令：

重命名/刪除表

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

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

要刪除一個已存在的數(shù)據(jù)表，可以使用 drop 或 dropIfExists 方法：

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

通過外鍵重命名表

在重命名表之前，需要驗證該表包含的外鍵在遷移文件中有明確的名字，而不是 Laravel 基于慣例分配的名字。否則，外鍵約束名將會指向舊的數(shù)據(jù)表。

數(shù)據(jù)列

創(chuàng)建數(shù)據(jù)列

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

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

可用的數(shù)據(jù)列類型

當然，Schema 構建器包含一系列你可以用來構建表的列類型：

列修改器

除了上面列出的數(shù)據(jù)列類型之外，在添加列的時候還可以使用一些其它的列“修改器”，例如，要使列允許為 NULL，可以使用 nullable 方法：

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

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

修改數(shù)據(jù)列

先決條件

在修改列之前，確保已經(jīng)將 doctrine/dbal 依賴添加到 composer.json 文件，Doctrine DBAL 庫用于判斷列的當前狀態(tài)并創(chuàng)建對列進行指定調整所需的 SQL 語句：

composer require doctrine/dbal

更新列屬性

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

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

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

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

注：只有以下數(shù)據(jù)列類型能修改：bigInteger, binary, boolean, date, dateTime, dateTimeTz, decimal, integer, json, longText, mediumText, smallInteger, string, text, time, unsignedBigInteger, unsignedInteger 和 unsignedSmallInteger。

重命名列

要重命名一個列，可以使用表結構構建器上的 renameColumn 方法，在重命名一個列之前，確保 doctrine/dbal 依賴已經(jīng)添加到 composer.json 文件并且已經(jīng)運行了 composer update 命令：

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

注：暫不支持 enum 類型的列的修改和重命名。

刪除數(shù)據(jù)列

要刪除一個列，使用 Schema 構建器上的 dropColumn 方法，同樣，在此之前，確保已經(jīng)安裝了 doctrine/dbal 依賴：

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

你可以通過傳遞列名數(shù)組到 dropColumn 方法以便可以一次從數(shù)據(jù)表中刪除多個列：

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

注：SQLite 數(shù)據(jù)庫暫不支持在單個遷移中刪除或修改多個列。

有效的命令別名

索引

創(chuàng)建索引

Schema 構建器支持多種類型的索引，首先，讓我們看一個指定列值為唯一索引的例子。要創(chuàng)建該索引，可以使用 unique 方法：

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

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

$table->unique('email');

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

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

Laravel 會自動生成合理的索引名稱，不過你也可以傳遞第二個參數(shù)到該方法用于指定索引名稱：

$table->index('email', 'unique_email');

可用索引類型

索引長度 & MySQL / MariaDB

Laravel 默認使用 utf8mb4 字符集，支持在數(shù)據(jù)庫中存儲 emoji 表情。如果你現(xiàn)在運行的 MySQL 版本低于 5.7.7（或者低于 10.2.2 版本的 MariaDB），需要手動配置遷移命令生成的默認字符串長度，以便 MySQL 為它們創(chuàng)建索引。你可以通過在 AppServiceProvider 中調用 Schema::defaultStringLength 方法來完成配置：

use Illuminate\Support\Facades\Schema;

/**
 * Bootstrap any application services.
 *
 * @return void
 * @translator laravelacademy.org
 */
public function boot()
{
  Schema::defaultStringLength(191);
}

作為可選方案，你可以為數(shù)據(jù)庫啟用 innodb_large_prefix 選項，至于如何合理啟用這個選項，可以參考數(shù)據(jù)庫文檔說明。

重命名索引

要重命名一個索引，可以使用 renameIndex 方法，這個方法接收當前索引名作為第一個參數(shù)以及修改后的索引名作為第二個參數(shù)：

$table->renameIndex('from', 'to')

刪除索引

要刪除索引，必須指定索引名。默認情況下，Laravel 自動分配適當?shù)拿Q給索引 —— 連接表名、列名和索引類型。下面是一些例子：

如果要傳遞數(shù)據(jù)列數(shù)組到刪除索引方法，那么相應的索引名稱將會通過數(shù)據(jù)表名、列和鍵類型來自動生成：

Schema::table('geo', function (Blueprint $table) {
  $table->dropIndex(['state']); // Drops index 'geo_state_index'
});

外鍵約束

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

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

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

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

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

$table->dropForeign('posts_user_id_foreign');

或者，你還可以傳遞在刪除時會自動使用基于慣例的約束名數(shù)值數(shù)組：

$table->dropForeign(['user_id']);

你可以在遷移時通過以下方法啟用或關閉外鍵約束：

Schema::enableForeignKeyConstraints();
Schema::disableForeignKeyConstraints();

注：由于使用外鍵風險級聯(lián)刪除風險較高，一般情況下我們很少使用外鍵，而是通過代碼邏輯來實現(xiàn)級聯(lián)操作。

以上就是本文的全部內容，希望對大家的學習有所幫助，也希望大家多多支持腳本之家。