全文翻译:laravel 5.1 官方文档 Database:Migrations

# 介绍(Introduction)

迁移就像是数据库的版本控制,可以方便团队的修改和共享数据库结构.迁移通常会和结构生成器一起使用,可以很简单的为你的应用创建数据库结构.
Laravel Schema facade提供一个与数据库无关的数据表创建和操作方法,它可以很好的处理 Laravel 支持的各种数据库类型,并且在不同系统间提供一致性的 API 操作。

# 创建迁移(Generating Migrations)

使用 Artisan CLI 的 make:migrate 命令建立迁移文件:

php artisan make:migration create_users_table

迁移文件会建立在 database/migrations 目录下,文件名会包含时间戳记,在执行迁移时用来确定顺序。
--table--create 参数可以用来指定数据表名称,以及迁移文件是否要建立新的数据表。
这些选项可以简单预填充到为指定的表生成的迁移存根文件:

php artisan make:migration add_votes_to_users_table --table=users

php artisan make:migration create_users_table --create=users

如果你想指定生成迁移文件的自定义导出路径,可以在执行make:migration命令使用--path参数,提供的路径应该是相对于应用程序的基本路径.

# 迁移结构(Migration Structure)

一个迁移类应包含两个方法:updown,up方法用于为数据库添加新的表,列或索引,而down方法应简单的反转有up方法执行的操作.

在这两种方法内,你可以使用Laravel的结构生成器意味深长的创建和修改数据表.要了解结构生成器所有的可用方法,点击这里.

下面我们以一个简单的articles迁移为例:

创建迁移文件:

php artisan make:migration create_articles_table

database/migrations/目录下会创建名称包含包含create_articles_table的文件

<?php

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

class CreateArticlesTable extends Migration
{
/**
* Run the migrations.
*
* @return void
*/
public function up()
{
Schema::create('articles', function (Blueprint $table) {
$table->increments('id');
$table->string('title', 60);
$table->string('body');
$table->timestamps();
});
}

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

# 运行迁移(Running Migrations)

通过Artisan命令migrate来运行所有未执行的迁移,如果你用的是Homestead虚拟机开发环境,你应该在你的VM里运行下面的命令:

php artisan migrate

如果运行命令报错class not found,可以试试这条命令composer dump-autoload,然后再重新执行上面的迁移命令.

在生产环境中强制迁移

有些迁移操作是破坏性的,可能导致你丢失数据,为了保护你的生产数据,当你对生产数据库执行这些命令之前,系统会提示您进行确认,如果不想系统提示确认,可以用参数--force:

php artisan migrate --force

回滚迁移

rollback命令可以回滚最近的一次迁移操作,注意,执行过的最后一“批”迁移可以包括多个迁移文件

php artisan migrate:rollback

migrate:reset命令可以回滚应用的所有迁移

php artisan migrate:reset

回滚/迁移单个命令

migrate:refresh命令会先回滚所有数据库迁移,然后再执行migrate命令,该命令会重建你的整个数据库

php artisan migrate:refresh

php artisan migrate:refresh --seed

# 编写迁移

创建表(Creating Tables)

用结构生成器(Schema facade)的create方法可以创建新的数据表.create方法有两个参数,第一个参数是表名,第二个参数是Closure(闭包函数),它接收一个Blueprint(蓝图)对象,用于创建新表

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

当然,在创建表时,你可以使用结构生成器的任何的列方法来定义表的列。

检查表/列是否存在

通过hasTablehasColumn方法,你可以很容易的检查表或列是否存在

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

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

连接和存储引擎(Connection & Storage Engine)

如果你要进行模式操作的数据库连接不是你的默认连接,可以使用connection方法:

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

通过设置结构生成器的engine参数,为一张表设置数据存储引擎

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

$table->increments('id');
});

重命名/删除表(Renaming / Dropping Tables)

rename方法可以重命名一个存在的数据表

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

dropdropIfExists方法可以删除一个存在的数据表

Schema::drop('users');

Schema::dropIfExists('users');

创建列(Creating Columns)

我们用结构生成器的table方法更新现有的表,和create方法类似,table方法接受两个参数:表名和一个Closure(闭包),它接收一个Blueprint(蓝图)实例,用于添加列到数据表:

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

可用列类型

数据表产生器提供多种字段类型可使用,在您建立数据表时也许会用到:

命令 功能描述
$table->bigIncrements('id'); ID 自动增量,使用相当于「big integer」类型
$table->bigInteger('votes'); 相当于 BIGINT 类型
$table->binary('data'); 相当于 BLOB 类型
$table->boolean('confirmed'); 相当于 BOOLEAN 类型
$table->char('name', 4); 相当于 CHAR 类型,并带有长度
$table->date('created_at'); 相当于 DATE 类型
$table->dateTime('created_at'); 相当于 DATETIME 类型
$table->decimal('amount', 5, 2); 相当于 DECIMAL 类型,并带有精度与基数
$table->double('column', 15, 8); 相当于 DOUBLE 类型,总共有 15 位数,在小数点后面有 8 位数
$table->enum('choices', array('foo', 'bar')); 相当于 ENUM 类型
$table->float('amount'); 相当于 FLOAT 类型
$table->increments('id'); 相当于 Incrementing 类型 (数据表主键)
$table->integer('votes'); 相当于 INTEGER 类型
$table->json('options'); 相当于 JSON 类型
$table->jsonb('options'); JSONB equivalent to the table
$table->longText('description'); 相当于 LONGTEXT 类型
$table->mediumInteger('numbers'); 相当于 MEDIUMINT 类型
$table->mediumText('description'); 相当于 MEDIUMTEXT 类型
$table->morphs('taggable'); 加入整数 taggable_id 与字串 taggable_type
$table->nullableTimestamps(); timestamps() 相同,但允许 NULL
$table->smallInteger('votes'); 相当于 SMALLINT 类型
$table->tinyInteger('numbers'); 相当于 TINYINT 类型
$table->softDeletes(); 加入 deleted_at 字段于软删除使用
$table->string('email'); 相当于 VARCHAR 类型
$table->string('name', 100); 相当于 VARCHAR 类型,并指定长度
$table->text('description'); 相当于 TEXT 类型
$table->time('sunrise'); 相当于 TIME 类型
$table->timestamp('added_on'); 相当于 TIMESTAMP 类型
$table->timestamps(); 加入 created_atupdated_at 字段
$table->rememberToken(); 加入 remember_token 使用 VARCHAR(100) NULL

列修饰符(Column Modifiers)

除了以上列出的列类型,还有几个列修饰符,可以在加入列的同时使用,例如,让某列”可以为空”,你可能会用到nullable方法:

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

下面是所有可用列修饰符列表,这个列表并不被包含在索引修饰符里:

修饰符 描述
->first() 将列调整为表的第一列 (MySQL Only)
->after(‘column’) 将列调整到’column’列的后面 (MySQL Only)
->nullable() 该列允许列插入空值
->default($value) 指定该列的默认值为$value
->unsigned() 指定 integer(整型) 列为 UNSIGNED(无符号)

修改列(Modifying Columns)

先决条件(Prerequisites)

修改列之前,请务必确定你的composer.json文件已添加依赖项doctrine/dbal,Doctrine DBAL库用于确定列的当前状态,并创建指定调整到列的SQL查询。

修改列属性

change能让你修改一个已经存在的列的类型或属性.例如:你像增加一个string类型列的字段长度,让我们看看change方法的行动力,假设我们想要将字段 name 的长度从 25 增加到 50:

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

我们还可以让这个字段可以为空

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 方法.

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

如果你给dropcolumn方法传递包含多个列名的数组,则可以移除多个列:

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

注意: 从SQLite数据库删除列前,你需要将composer.json 文件内已经加入 doctrine/dbal,并在终端运行composer update来安装库.

创建索引

结构生成器支持多种索引类型.首先,让我们来看一个例子,它指定列的值应该是唯一的。要创建索引,我们可以在定义列的时候,用unique方法链上去:

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

或者,您可以先定义列,之后再创建索引,例如:

$table->unique('email');

你甚至可以将一个数组传递给一个索引方法来创建一个复合索引:

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

可用的索引类型

命令 功能描述
$table->primary(‘id’); 添加主键 (primary key)
$table->primary([‘first’, ‘last’]); 添加组合键(composite keys)
$table->unique(‘email’); 添加唯一索引 (unique index)
$table->index(‘state’); 添加基本索引 (index)

移除索引

要移除索引就必须指定索引名称,默认情况下,Laravel 默认有脉络可循的索引名称。简单地链接这些数据表与索引的字段名称和类型。举例如下:

命令 功能描述
$table->dropPrimary('users_id_primary'); 从「users」数据表移除主键
$table->dropUnique('users_email_unique'); 从「users」数据表移除唯一索引
$table->dropIndex('geo_state_index'); 从「geo」数据表移除基本索引

移除时间戳记和软删除

要移除 timestampsnullableTimestampssoftDeletes 字段类型,您可以使用以下方法:

命令 功能描述
$table->dropTimestamps(); 移除 created_atupdated_at 字段
$table->dropSoftDeletes(); 移除 deleted_at 字段

保存引擎

要配置数据表的保存引擎,可在结构生成器配置 engine 属性:

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

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

外键约束

Laravel 也支持数据表的外键约束,这是用来在数据库级别强制引用完整性,例如:我们在posts表定义的user_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」进行约束动作:

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

要移除外键,可使用 dropForeign 方法。外键的命名约定雷同其他索引,因此,我们可以连接约束中的表名和列,后缀为_foreign:

$table->dropForeign('posts_user_id_foreign');
0%