目录
- 一:创建迁移
- 二:迁移结构
- 1:up方法
- 2:down方法
- 三:运行迁移
- 四:迁移回滚
- 五:回滚后迁移
- 六:可用字段类型
- 七:字段修饰
- 八:修改字段
- 九:删除字段
- 十:索引长度 & Mysql / MariaDB
- 十一:外键约束
一:创建迁移
在laravel中使用make:migration命令来创建迁移
php artisan make:migration create_user_table
执行上面的命令后这时候会在database/migrations 目录下生成对应的迁移文件,每个迁移的文件名都包含一个时间戳来让 Laravel 确认迁移的顺序
二:迁移结构
一个迁移类包含两个方法: up 和 down。up 方法是用于新增数据库的数据表、字段或者索引的,而 down 方法应该与 up 方法的执行操作相反。
1:up方法
public function up()
{
Schema::create('user', function (Blueprint $table) {
$table->bigIncrements('id');
$table->string('name');
$table->string('email')->unique();
$table->timestamp('email_verified_at')->nullable();
$table->string('password');
$table->rememberToken();
$table->timestamps();
});
}
2:down方法
public function down()
{
Schema::dropIfExists('user');
}
三:运行迁移
php artisan migrate
大多数迁移操作都是破坏性的,这意味着也许会丢失数据。为了防止有人在生产环境数据中运行这些命令,在执行这些命令之前将提示你进行确认。如果要强制迁移命令在没有提示的情况下运行,请使用 --force 参数
php artisan migrate --force
四:迁移回滚
php artisan migrate:rollback
通过向 rollback 命令加上 step 参数,可以回滚指定数量的迁移
php artisan migrate:rollback --step=
migrate:reset 命令将会滚回你应用程序所有的迁移:
php artisan migrate:reset
五:回滚后迁移
migrate:refresh 命令将会在回滚你所有的迁移后执行 migrate 命令。这个命令可以高效的重新创建你的整个数据库:
php artisan migrate:refresh
// 刷新数据库并执行数据库填充
php artisan migrate:refresh --seed
六:可用字段类型
在laravel的数据库迁移中,支持的字段类型有:
命令 | 描述 |
$table->bigIncrements('id'); | 递增 ID(主键),相当于「UNSIGNED BIG INTEGER」 |
$table->bigInteger('votes'); | 相当于 BIGINT |
$table->binary('data'); | 相当于 BLOB |
$table->boolean('confirmed'); | 相当于 BOOLEAN |
$table->char('name', 100); | 相当于带有长度的 CHAR |
$table->date('created_at'); | 相当于 DATE |
$table->dateTime('created_at'); | 相当于 DATETIME |
$table->dateTimeTz('created_at'); | 相当于带时区 DATETIME |
$table->decimal('amount', 8, 2); | 相当于带有精度与基数 DECIMAL |
$table->double('amount', 8, 2); | 相当于带有精度与基数 DOUBLE |
$table->enum('level', ['easy', 'hard']); | 相当于 ENUM |
$table->float('amount', 8, 2); | 相当于带有精度与基数 FLOAT |
$table->geometry('positions'); | 相当于 GEOMETRY |
$table->geometryCollection('positions'); | 相当于 GEOMETRYCOLLECTION |
$table->increments('id'); | 递增的 ID (主键),相当于「UNSIGNED INTEGER」 |
$table->integer('votes'); | 相当于 INTEGER |
$table->ipAddress('visitor'); | 相当于 IP 地址 |
$table->json('options'); | 相当于 JSON |
$table->jsonb('options'); | 相当于 JSONB |
$table->lineString('positions'); | 相当于 LINESTRING |
$table->longText('description'); | 相当于 LONGTEXT |
$table->macAddress('device'); | 相当于 MAC 地址 |
$table->mediumIncrements('id'); | 递增 ID (主键) ,相当于「UNSIGNED MEDIUM INTEGER」 |
$table->mediumInteger('votes'); | 相当于 MEDIUMINT |
$table->mediumText('description'); | 相当于 MEDIUMTEXT |
$table->morphs('taggable'); | 相当于加入递增的 taggable_id 与字符串 taggable_type |
$table->uuidMorphs('taggable'); | 相当于加入 taggable_id 与字符串 taggable_typeUUID 列。 |
$table->multiLineString('positions'); | 相当于 MULTILINESTRING |
$table->multiPoint('positions'); | 相当于 MULTIPOINT |
$table->multiPolygon('positions'); | 相当于 MULTIPOLYGON |
$table->nullableMorphs('taggable'); | 相当于可空版本的 morphs () 字段 |
$table->nullableUuidMorphs('taggable'); | 相当于可空版本的 uuidMorphs() 字段 |
$table->nullableTimestamps(); | 相当于可空版本的 timestamps() 字段 |
$table->point('position'); | 相当于 POINT |
$table->polygon('positions'); | 相当于 POLYGON |
$table->rememberToken(); | 相当于可空版本的 VARCHAR (100) 的 remember_token 字段 |
$table->set('flavors', ['strawberry', 'vanilla']); | 相当于 SET |
$table->smallIncrements('id'); | 递增 ID(主键),相当于「UNSIGNED SMALLINT」 |
$table->smallInteger('votes'); | 相当于 SMALLINT |
$table->softDeletes(); | 相当于为软删除添加一个可空的 deleted_at 字段 |
$table->softDeletesTz(); | 相当于为软删除添加一个可空的 带时区的 deleted_at 字段 |
$table->string('name', 100); | 相当于带长度的 VARCHAR |
$table->text('description'); | 相当于 TEXT |
$table->time('sunrise'); | 相当于 TIME |
$table->timeTz('sunrise'); | 相当于带时区的 TIME |
$table->timestamp('added_on'); | 相当于 TIMESTAMP |
$table->timestampTz('added_on'); | 相当于带时区的 TIMESTAMP |
$table->timestamps(); | 相当于可空的 created_at 和 updated_at TIMESTAMP |
$table->timestampsTz(); | 相当于可空且带时区的 created_at 和 updated_at TIMESTAMP |
$table->tinyIncrements('id'); | 相当于自动递增 UNSIGNED TINYINT |
$table->tinyInteger('votes'); | 相当于 TINYINT |
$table->unsignedBigInteger('votes'); | 相当于 Unsigned BIGINT |
$table->unsignedDecimal('amount', 8, 2); | 相当于带有精度和基数的 UNSIGNED DECIMAL |
$table->unsignedInteger('votes'); | 相当于 Unsigned INT |
$table->unsignedMediumInteger('votes'); | 相当于 Unsigned MEDIUMINT |
$table->unsignedSmallInteger('votes'); | 相当于 Unsigned SMALLINT |
$table->unsignedTinyInteger('votes'); | 相当于 Unsigned TINYINT |
$table->uuid('id'); | 相当于 UUID |
$table->year('birth_year'); | 相当于 YEAR |
七:字段修饰
在laravel的数据库迁移中,支持的字段修饰符有:
命令 | 描述 |
->after('column') | 将此字段放置在其它字段 "之后" (MySQL) |
->autoIncrement() | 将 INTEGER 类型的字段设置为自动递增的主键 |
->charset('utf8') | 指定一个字符集 (MySQL) |
->collation('utf8_unicode_ci') | 指定列的排序规则 (MySQL/SQL Server) |
->comment('my comment') | 为字段增加注释 (MySQL) |
->default($value) | 为字段指定 "默认" 值 |
->first() | 将此字段放置在数据表的 "首位" (MySQL) |
->nullable($value = true) | 此字段允许写入 NULL 值(默认情况下) |
->storedAs($expression) | 创建一个存储生成的字段 (MySQL) |
->unsigned() | 设置 INTEGER 类型的字段为 UNSIGNED (MySQL) |
->useCurrent() | 将 TIMESTAMP 类型的字段设置为使用 CURRENT_TIMESTAMP 作为默认值 |
->virtualAs($expression) | 创建一个虚拟生成的字段 (MySQL) |
->generatedAs($expression) | 使用指定的序列生成标识列(PostgreSQL) |
->always() | 定义序列值优先于标识列的输入 (PostgreSQL) |
->primary('id') | 添加主键 |
->primary(['id', 'parent_id']) | 添加复合键 |
->unique('email') | 添加唯一索引 |
->index('state') | 添加普通索引 |
->spatialIndex('location') | 添加空间索引(不支持 SQLite) |
->renameIndex('from', 'to') | 重命名索引 |
->dropPrimary('users_id_primary') | 删除主键 |
->dropUnique('users_email_unique'); | 删除唯一索引 |
>dropIndex('geo_state_index'); | 删除基本索引 |
->dropSpatialIndex('geo_location_spatialindex'); | 删除空间索引(不支持 SQLite) |
实例:
Schema::table('users', function (Blueprint $table) {
$table->string('email')->nullable();
});
八:修改字段
change 方法可以将现有的字段类型修改为新的类型或修改属性,例:
Schema::table('users', function (Blueprint $table) {
$table->string('name',)->change();
});
renameColumn方法来重命名字段,依赖于doctrine/dbal拓展,例:
Schema::table('users', function (Blueprint $table) {
$table->renameColumn('from', 'to');
});
九:删除字段
dropColumn 方法来删除字段,例:
Schema::table('users', function (Blueprint $table) {
$table->dropColumn(['votes', 'avatar', 'location']);//删除votes,avatar,location字段
});
十:索引长度 & Mysql / MariaDB
Laravel 默认使用 utf8mb4 编码,它支持在数据库中储存 emojis 。如果你是在版本低于 5.7.7 的 MySQL 或者版本低于 10.2.2 的 MariaDB 上创建索引,那你就需要手动配置数据库迁移的默认字符串长度。即在 app/Providers/AppServiceProvider 中调用 Schema::defaultStringLength 方法来配置它
use Illuminate\Support\Facades\Schema;
/**
* Bootstrap any application services.
*
* @return void
*/
public function boot()
{
Schema::defaultStringLength();
}
十一:外键约束
Laravel 还支持创建用于在数据库层中的强制引用完整性的外键约束。例如,让我们在 posts 表上定义一个引用 users 表的 id 字段的 user_id 字段:
Schema::table('posts', function (Blueprint $table) {
$table->unsignedBigInteger('user_id');
$table->foreign('user_id')->references('id')->on('users');
});
在迁移文件中使用以下方法来开启或关闭外键约束
Schema::enableForeignKeyConstraints();
Schema::disableForeignKeyConstraints();