Laravel中資料庫遷移操作的範例詳解

2023-02-10 06:00:35

一：建立遷移

在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=5

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', 50)->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 IlluminateSupportFacadesSchema;
 
/**
 * Bootstrap any application services.
 *
 * @return void
 */
public function boot()
{
    Schema::defaultStringLength(191);
}

十一：外來鍵約束

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();

到此這篇關於Laravel中資料庫遷移操作的範例詳解的文章就介紹到這了,更多相關Laravel資料庫遷移內容請搜尋it145.com以前的文章或繼續瀏覽下面的相關文章希望大家以後多多支援it145.com！