Laravel中数据库迁移操作的示例详解

Laravel框架
731
0
0
2023-08-05
目录
  • 一:创建迁移
  • 二:迁移结构
  • 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();