#数据库迁移
数据库迁移
所谓迁移就像是数据库的版本控制,
这种机制允许团队简单轻松的编辑并共享应用的数据库表结构。
迁移通常和 Laravel 的 schema 构建器结对从而可以很容易地构建应用的数据库表结构。
如果你曾经频繁告知团队成员需要手动添加列到本地数据库表结构以维护本地开发环境,
那么这正是数据库迁移所致力于解决的问题。
Laravel 的 Schema 门面提供了与数据库系统无关的创建和操纵表的支持,
在 Laravel 所支持的所有数据库系统中提供一致的、优雅的、流式的 API。
##生成迁移
php artisan make:migration create_users_table //users相当于表名可换为member
php artisan make:migration create_users_table --create=users
php artisan make:migration add_votes_to_users_table --table=users
##迁移结构
迁移类包含up、down方法
increments('id');
$table->string('name');
$table->string('airline');
$table->timestamps();
});
}
/**
* Reverse the migrations.
*
* @return void
*/
public function down()
{
Schema::drop('flights');
}
}
##运行迁移
运行应用中所有未执行的迁移
//首次执行要执行以下句子
php artisan migrate:install
//执行成功后,migrations表中多记录,执行对象表会变化
php artisan migrate
##回滚迁移
想要回滚最新的一次迁移”操作“,可以使用 rollback 命令,
注意这将会回滚最后一批运行的迁移,可能包含多个迁移文件
php artisan migrate:rollback --step=5
php artisan migrate:reset
php artisan migrate:refresh
//重建数据库并填充数据...
php artisan migrate:refresh --seed
//回滚重建指定步数的迁移
php artisan migrate:refresh --seed
##删除所有表&迁移
php artisan migrate:fresh
php artisan migrate:fresh --seed
##数据表
###创建数据表 create方法
//位于up方法中
Schema::create('users', function (Blueprint $table) {
$table->integerIncrements('id');
});
###检查表/列是否存在
if (Schema::hasTable('users')) {
//
}
if (Schema::hasColumn('users', 'email')) {
//
}
###数据库连接 & 表选项
Schema::connection('foo')->create('users', function (Blueprint $table) {
$table->increments('id');
});
###重命名/删除表
//重命名
Schema::rename($from, $to);
//删除所有表
Schema::drop('users');
Schema::dropIfExists('users');
##数据列
###创建数据列 table方法
Schema::table('users', function (Blueprint $table) {
$table->string('email');
});
###列修改器
//添加列时,使用列修改器
Schema::table('users', function (Blueprint $table) {
$table->string('email')->nullable();
});
命令 | 描述 |
---|---|
$table->bigIncrements(‘id’); | 等同于自增 UNSIGNED BIGINT(主键)列 |
$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->dateTimeTz(‘created_at’); | 等同于 DATETIME 类型(带时区)列 |
$table->decimal(‘amount’, 5, 2); | 等同于 DECIMAL 类型列,带精度和范围 |
$table->double(‘column’, 15, 8); | 等同于 DOUBLE 类型列,带精度, 总共15位数字,小数点后8位 |
$table->enum(‘level’, [‘easy’, ‘hard’]); | 等同于 ENUM 类型列 |
$table->float(‘amount’, 8, 2); | 等同于 FLOAT 类型列,带精度和总位数 |
$table->geometry(‘positions’); | 等同于 GEOMETRY 类型列 |
$table->geometryCollection(‘positions’); | 等同于 GEOMETRYCOLLECTION 类型列 |
$table->increments(‘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’); | 等同于自增 UNSIGNED MEDIUMINT 类型列(主键) |
$table->mediumInteger(‘numbers’); | 等同于 MEDIUMINT 类型列 |
$table->mediumText(‘description’); | 等同于 MEDIUMTEXT 类型列 |
$table->morphs(‘taggable’); | 添加一个 UNSIGNED INTEGER 类型的 taggable_id 列和一个 VARCHAR 类型的 taggable_type 列 |
$table->multiLineString(‘positions’); | 等同于 MULTILINESTRING 类型列 |
$table->multiPoint(‘positions’); | 等同于 MULTIPOINT 类型列 |
$table->multiPolygon(‘positions’); | 等同于 MULTIPOLYGON 类型列 |
$table->nullableMorphs(‘taggable’); | morphs() 列的 nullable 版本 |
$table->nullableTimestamps(); | timestamps() 的别名 |
$table->point(‘position’); | 等同于 POINT 类型列 |
$table->polygon(‘positions’); | 等同于 POLYGON 类型列 |
$table->rememberToken(); | 等同于添加一个允许为空的 remember_token VARCHAR(100) 列 |
$table->smallIncrements(‘id’); | 等同于自增 UNSIGNED SMALLINT (主键)类型列 |
$table->smallInteger(‘votes’); | 等同于 SMALLINT 类型列 |
$table->softDeletes(); | 新增一个允许为空的 deleted_at TIMESTAMP 列用于软删除 |
$table->softDeletesTz(); | 新增一个允许为空的 deleted_at TIMESTAMP (带时区)列用于软删除 |
$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(‘numbers’); | 等同于自增的 UNSIGNED TINYINT 类型列(主键) |
$table->tinyInteger(‘numbers’); | 等同于 TINYINT 类型列 |
$table->unsignedBigInteger(‘votes’); | 等同于无符号的 BIGINT 类型列 |
$table->unsignedDecimal(‘amount’, 8, 2); | 等同于 UNSIGNED DECIMAL 类型列,带有总位数和精度 |
$table->unsignedInteger(‘votes’); | 等同于无符号的 INTEGER 类型列 |
$table->unsignedMediumInteger(‘votes’); | 等同于无符号的 MEDIUMINT 类型列 |
$table->unsignedSmallInteger(‘votes’); | 等同于无符号的 SMALLINT 类型列 |
$table->unsignedTinyInteger(‘votes’); | 等同于无符号的 TINYINT 类型列 |
$table->uuid(‘id’); | 等同于 UUID 类型列 |
$table->year(‘birth_year’); | 等同于 YEAR 类型列 |
修改器 | 描述 |
---|---|
->after(‘column’) | 将该列置于另一个列之后 (MySQL) |
->autoIncrement() | 设置 INTEGER 列为自增主键 |
->charset(‘utf8’) | 指定数据列字符集(MySQL) |
->collation(‘utf8_unicode_ci’) | 指定数据列字符序(MySQL/SQL Server) |
->comment(‘my comment’) | 添加注释信息 |
->default($value) | 指定列的默认值 |
->first() | 将该列置为表中第一个列 (MySQL) |
->nullable($value = true) | 允许该列的值为 NULL |
->storedAs($expression) | 创建一个存储生成列(MySQL) |
->unsigned() | 设置 INTEGER 列为 UNSIGNED(MySQL) |
->useCurrent() | 设置 TIMESTAMP 列使用 CURRENT_TIMESTAMP 作为默认值 |
->virtualAs($expression) | 创建一个虚拟生成列(MySQL) |
composer require doctrine/dbal
//将 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();
});
确保 doctrine/dbal 依赖已经添加到 composer.json 文件,
并且已经运行了 composer update 命令
Schema::table('users', function (Blueprint $table) {
$table->renameColumn('from', 'to');
});
确保已经安装了 doctrine/dbal 依赖
//删除一列
Schema::table('users', function (Blueprint $table) {
$table->dropColumn('votes');
});
//删除多列
Schema::table('users', function (Blueprint $table) {
$table->dropColumn(['votes', 'avatar', 'location']);
});
##索引
###索引命名规则
连接表名、列名和索引类型
###创建索引
$table->string('email')->unique();
$table->unique('email');
$table->index(['account_id', 'created_at']);
$table->index('email', 'unique_email');
命令 | 描述 |
---|---|
$table->primary(‘id’); | 添加主键索引 |
$table->primary([‘id’, ‘parent_id’]); | 添加组合索引 |
$table->unique(‘email’); | 添加唯一索引 |
$table->index(‘state’); | 添加普通索引 |
$table->spatialIndex(‘location’); | 添加空间索引(不支持SQLite) |
###删除索引
命令 | 描述 |
---|---|
$table->dropPrimary(‘users_id_primary’); | 从 “users” 表中删除主键索引 |
$table->dropUnique(‘users_email_unique’); | 从 “users” 表中删除唯一索引 |
$table->dropIndex(‘geo_state_index’); | 从 “geo” 表中删除普通索引 |
$table->dropSpatialIndex(‘geo_location_spatialindex’); | 从 “geo” 表中删除空间索引(不支持SQLite) |
##外键约束
###外键命名规则
连接表名、外键名然后加上“_foreign”后缀
类似索引命名规则
###创建外键
Schema::table('posts', function (Blueprint $table) {
$table->integer('user_id')->unsigned();
$table->foreign('user_id')->references('id')->on('users');
});
###删除外键
$table->dropForeign('posts_user_id_foreign');
$table->dropForeign(['user_id']);
###启用/关闭外键 --迁移时
Schema::enableForeignKeyConstraints();
Schema::disableForeignKeyConstraints();