結構生成器

介紹

Laravel 的結構生成器 (Schema) 提供一個與數(shù)據(jù)庫無關的數(shù)據(jù)表產生方法，它可以很好的處理 Laravel 支持的各種數(shù)據(jù)庫類型，并且在不同系統(tǒng)間提供一致性的 API 操作。

建立與刪除數(shù)據(jù)表

要建立一個新的數(shù)據(jù)表，可使用Schema::create 方法：

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

傳入 create 方法的第一個參數(shù)是數(shù)據(jù)表名稱，第二個參數(shù)是 Closure 并接收Blueprint 對象被用來定義新的數(shù)據(jù)表。

要修改數(shù)據(jù)表名稱，可使用 rename 方法：

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

要指定特定連接來操作，可使用 Schema::connection 方法：

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

要移除數(shù)據(jù)表，可使用 Schema::drop 方法：

Schema::drop('users');

Schema::dropIfExists('users');

加入字段

更新現(xiàn)有的數(shù)據(jù)表，可使用 Schema::table 方法：

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

數(shù)據(jù)表產生器提供多種字段類型可使用，在您建立數(shù)據(jù)表時也許會用到：

在 MySQL 使用 After 方法

若您使用 MySQL 數(shù)據(jù)庫，您可以使用 after 方法來指定字段的順序：

$table->string('name')->after('email');

修改字段

有時候您需要修改一個存在的字段，例如：您可能想增加保存文本字段的長度。通過 change 方法讓這件事情變得非常容易！假設我們想要將字段 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();
});

修改字段名稱

要修改字段名稱，可在結構生成器內使用 renameColumn 方法，請確認在修改前composer.json 文件內已經加入 doctrine/dbal。

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

注意: 目前暫時還不支持修改表中的結構為 enum 字段類型。

移除字段

要移除字段，可在結構生成器內使用 dropColumn 方法，請確認在移除前composer.json 文件內已經加入 doctrine/dbal。

移除數(shù)據(jù)表字段

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

移除數(shù)據(jù)表多個字段

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

檢查是否存在

檢查數(shù)據(jù)表是否存在

您可以輕松的檢查數(shù)據(jù)表或字段是否存在，使用 hasTable 和 hasColumn 方法：

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

檢查字段是否存在

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

加入索引

結構生成器支持多種索引類型，有兩種方法可以加入，方法一，您可以在定義字段時順便附加上去，或者是分開另外加入：

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

或者，您可以獨立一行來加入索引，以下是支持的索引類型：

外鍵

Laravel 也支持數(shù)據(jù)表的外鍵約束：

$table->integer('user_id')->unsigned();
$table->foreign('user_id')->references('id')->on('users');

例子中，我們關注字段 user_id 參照到 users 數(shù)據(jù)表的 id 字段。請先確認已經建立外鍵！

您也可以指定選擇在「on delete」和「on update」進行約束動作：

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

要移除外鍵，可使用 dropForeign 方法。外鍵的命名約定如同其他索引：

$table->dropForeign('posts_user_id_foreign');

注意: 當外鍵有參照到自動增量時，記得配置外鍵為 unsigned 類型。

移除索引

要移除索引您必須指定索引名稱，Laravel 默認有脈絡可循的索引名稱。簡單地鏈接這些數(shù)據(jù)表與索引的字段名稱和類型。舉例如下：

移除時間戳記和軟刪除

要移除 timestamps、nullableTimestamps 或 softDeletes 字段類型，您可以使用以下方法：

保存引擎

要配置數(shù)據(jù)表的保存引擎，可在結構生成器配置 engine 屬性：

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

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