Laravel中數據庫遷移操作的示例詳解

一:創建遷移

在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 Illuminate\Support\Facades\Schema;
 
/**
 * 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數據庫遷移內容請搜索WalkonNet以前的文章或繼續瀏覽下面的相關文章希望大傢以後多多支持WalkonNet!

推薦閱讀: