结构生成器

简介

Laravel 的 Schema 类提供了一种与数据库无关的方式维护表。它和 Laravel 所支持的所有数据库都能很好的工作，并且提供了统一的接口。

使用 Schema::create 创建一个数据库的表：

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

传递给 create 函数的第一个参数是表的名字，第二个参数是一个闭包，将接受一个 Blueprint 对象用于定义新的表。

使用 rename 函数重命名一个已存在的表：

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

使用 Schema::connection 函数指定结构操作所使用的数据库连接：

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

使用 Schema::drop 函数删除一个表：

Schema::drop('users');

Schema::dropIfExists('users');

使用 Schema::table 函数更新一个已存在的表：

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

表生成器包含一系列的字段类型用于构建表：

命令	描述
`$table->increments('id');`	自动增长的 ID (主键).
`$table->bigIncrements('id');`	类似"big integer"类型的自动增长的 ID.
`$table->string('email');`	VARCHAR 类型
`$table->string('name', 100);`	带长度的 VARCHAR 类型
`$table->integer('votes');`	INTEGER 类型
`$table->bigInteger('votes');`	BIGINT 类型
`$table->smallInteger('votes');`	SMALLINT 类型
`$table->float('amount');`	FLOAT 类型
`$table->double('column', 15, 8);`	设置了精度的DOUBLE类型
`$table->decimal('amount', 5, 2);`	带精度和小数的 DECIMAL
`$table->boolean('confirmed');`	BOOLEAN 类型
`$table->date('created_at');`	DATE 类型
`$table->dateTime('created_at');`	DATETIME 类型
`$table->time('sunrise');`	TIME 类型
`$table->timestamp('added_on');`	TIMESTAMP 类型
`$table->timestamps();`	添加 created_at 和 updated_at 列
`$table->softDeletes();`	添加 deleted_at 列用于软删除
`$table->text('description');`	TEXT 类型
`$table->longtext('description');`	LONGTEXT 类型
`$table->binary('data');`	BLOB 类型
`$table->enum('choices', array('foo', 'bar'));`	ENUM 类型
`->nullable()`	指明该字段允许 NULL 值
`->default($value)`	为字段声明一个默认值
`->unsigned()`	设置 INTEGER 为无符号

如果你使用 MySQL 数据库，您可以使用 after 函数指明字段的顺序：

在 MySQL 中使用 After

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

使用 renameColumn 函数重命名一个字段：

重命名一个字段

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

注意: 不支持重命名 enum 字段类型.

从表中删除一个字段

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

从表中删除多个字段

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

您可以使用 hasTable 和 hasColumn 检查一个表或一个字段是否存在：

检查表是否存在

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

检查字段是否存在

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

结构生成器支持多种类型的索引，有两种方法可以添加它们。首先，您可以在字段定义后链式的定义它们，或者独立的添加它们：

链式创建一个字段和索引

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

或者，您可以选择在不同的行添加索引。下面是全部支持的索引类型：

命令	描述
`$table->primary('id');`	添加一个主键
`$table->primary(array('first', 'last'));`	添加组合键
`$table->unique('email');`	添加唯一键
`$table->index('state');`	添加一个索引

Laravel 也支持向表中添加外键约束：

向表中添加外键

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

在这个例子中，我们指明 user_id 字段参照 users 表中的 id 字段。

您也可以指明 "on delete" 以及 "on update" 行为选项：

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

可以使用 dropForeign 函数删除一个外键。像其他索引一样，一个相似的命名惯例被使用于外键的命名：

$table->dropForeign('posts_user_id_foreign');

注意: 当创建一个参照递增整数类型的外键的时候，记得把外键字段的类型定义为无符号。

为了删除索引，必须指明索引的名字。Laravel 默认为索引分配了一个合理的名字。通过连接表明、索引的字段名以及索引类型的形式。这里是一些例子：

命令	描述
`$table->dropPrimary('users_id_primary');`	从 "users" 表中删除一个主键
`$table->dropUnique('users_email_unique');`	从 "users" 表中删除一个唯一键
`$table->dropIndex('geo_state_index');`	从 "geo" 表中删除一个索引

通过在结构生成器设置 engine 属性为表设置存储引擎：

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

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