命令 | 描述 |
---|---|
$table->engine = 'InnoDB'; | 指定表的存儲引擎(MySQL) |
$table->charset = 'utf8'; | 指定數(shù)據(jù)表的默認(rèn)字符集(MySQL) |
$table->collation = 'utf8_unicode_ci'; | 指定數(shù)據(jù)表的字符序(MySQL) |
$table->temporary(); | 創(chuàng)建臨時表(除SQL Server) |
重命名/刪除表
要重命名一個已存在的數(shù)據(jù)表,使用 rename 方法:
Schema::rename($from, $to);
要刪除一個已存在的數(shù)據(jù)表,可以使用 drop 或 dropIfExists 方法:
Schema::drop('users'); Schema::dropIfExists('users');
通過外鍵重命名表
在重命名表之前,需要驗證該表包含的外鍵在遷移文件中有明確的名字,而不是 Laravel 基于慣例分配的名字。否則,外鍵約束名將會指向舊的數(shù)據(jù)表。
創(chuàng)建數(shù)據(jù)列
要更新一個已存在的表,使用 Schema 門面上的 table 方法,和 create 方法一樣,table 方法接收兩個參數(shù):表名和獲取用于添加列到表的 Blueprint 實例的閉包:
Schema::table('users', function (Blueprint $table) { $table->string('email'); });
可用的數(shù)據(jù)列類型
當(dāng)然,Schema 構(gòu)建器包含一系列你可以用來構(gòu)建表的列類型:
命令 | 描述 |
---|---|
$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 類型(帶時區(qū))列 |
$table->decimal('amount', 5, 2); | 等同于 DECIMAL 類型列,帶精度和范圍 |
$table->double('column', 15, 8); | 等同于 DOUBLE 類型列,帶精度, 總共15位數(shù)字,小數(shù)點后8位 |
$table->enum('level', ['easy', 'hard']); | 等同于 ENUM 類型列 |
$table->float('amount', 8, 2); | 等同于 FLOAT 類型列,帶精度和總位數(shù) |
$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 (帶時區(qū))列用于軟刪除 |
$table->string('name', 100); | 等同于 VARCHAR 類型列,帶一個可選長度參數(shù) |
$table->text('description'); | 等同于 TEXT 類型列 |
$table->time('sunrise'); | 等同于 TIME 類型列 |
$table->timeTz('sunrise'); | 等同于 TIME 類型(帶時區(qū)) |
$table->timestamp('added_on'); | 等同于 TIMESTAMP 類型列 |
$table->timestampTz('added_on'); | 等同于 TIMESTAMP 類型(帶時區(qū))列 |
$table->timestamps(); | 添加允許為空的 created_at 和 updated_at TIMESTAMP 類型列 |
$table->timestampsTz(); | 添加允許為空的 created_at 和 updated_at TIMESTAMP 類型列(帶時區(qū)) |
$table->tinyIncrements('numbers'); | 等同于自增的 UNSIGNED TINYINT 類型列(主鍵) |
$table->tinyInteger('numbers'); | 等同于 TINYINT 類型列 |
$table->unsignedBigInteger('votes'); | 等同于無符號的 BIGINT 類型列 |
$table->unsignedDecimal('amount', 8, 2); | 等同于 UNSIGNED DECIMAL 類型列,帶有總位數(shù)和精度 |
$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 類型列 |
列修改器
除了上面列出的數(shù)據(jù)列類型之外,在添加列的時候還可以使用一些其它的列“修改器”,例如,要使列允許為 NULL,可以使用 nullable 方法:
Schema::table('users', function (Blueprint $table) { $table->string('email')->nullable(); });
下面是所有可用的列修改器列表,該列表不包含索引修改器:
修改器 | 描述 |
---|---|
->after('column') | 將該列置于另一個列之后 (MySQL) |
->autoIncrement() | 設(shè)置 INTEGER 列為自增主鍵 |
->charset('utf8') | 指定數(shù)據(jù)列字符集(MySQL) |
->collation('utf8_unicode_ci') | 指定數(shù)據(jù)列字符序(MySQL/SQL Server) |
->comment('my comment') | 添加注釋信息 |
->default($value) | 指定列的默認(rèn)值 |
->first() | 將該列置為表中第一個列 (MySQL) |
->nullable($value = true) | 允許該列的值為 NULL |
->storedAs($expression) | 創(chuàng)建一個存儲生成列(MySQL) |
->unsigned() | 設(shè)置 INTEGER 列為 UNSIGNED(MySQL) |
->useCurrent() | 設(shè)置 TIMESTAMP 列使用 CURRENT_TIMESTAMP 作為默認(rèn)值 |
->virtualAs($expression) | 創(chuàng)建一個虛擬生成列(MySQL) |
修改數(shù)據(jù)列
先決條件
在修改列之前,確保已經(jīng)將 doctrine/dbal 依賴添加到 composer.json 文件,Doctrine DBAL 庫用于判斷列的當(dāng)前狀態(tài)并創(chuàng)建對列進行指定調(diào)整所需的 SQL 語句:
composer require doctrine/dbal
更新列屬性
change 方法允許你修改已存在的列為新的類型,或者修改列的屬性。例如,你可能想要增加 字符串類型列的尺寸,下面讓我們將 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(); });
注:只有以下數(shù)據(jù)列類型能修改:bigInteger, binary, boolean, date, dateTime, dateTimeTz, decimal, integer, json, longText, mediumText, smallInteger, string, text, time, unsignedBigInteger, unsignedInteger 和 unsignedSmallInteger。
重命名列
要重命名一個列,可以使用表結(jié)構(gòu)構(gòu)建器上的 renameColumn 方法,在重命名一個列之前,確保 doctrine/dbal 依賴已經(jīng)添加到 composer.json 文件并且已經(jīng)運行了 composer update 命令:
Schema::table('users', function (Blueprint $table) { $table->renameColumn('from', 'to'); });
注:暫不支持 enum 類型的列的修改和重命名。
刪除數(shù)據(jù)列
要刪除一個列,使用 Schema 構(gòu)建器上的 dropColumn 方法,同樣,在此之前,確保已經(jīng)安裝了 doctrine/dbal 依賴:
Schema::table('users', function (Blueprint $table) { $table->dropColumn('votes'); });
你可以通過傳遞列名數(shù)組到 dropColumn 方法以便可以一次從數(shù)據(jù)表中刪除多個列:
Schema::table('users', function (Blueprint $table) { $table->dropColumn(['votes', 'avatar', 'location']); });
注:SQLite 數(shù)據(jù)庫暫不支持在單個遷移中刪除或修改多個列。
有效的命令別名
命令 | 描述 |
---|---|
$table->dropRememberToken(); | 刪除 remember_token 列 |
$table->dropSoftDeletes(); | 刪除 deleted_at 列 |
$table->dropSoftDeletesTz(); | dropSoftDeletes() 方法別名 |
$table->dropTimestamps(); | 刪除 created_at 和 updated_at 列 |
$table->dropTimestampsTz(); | dropTimestamps() 方法別名 |
創(chuàng)建索引
Schema 構(gòu)建器支持多種類型的索引,首先,讓我們看一個指定列值為唯一索引的例子。要創(chuàng)建該索引,可以使用 unique 方法:
$table->string('email')->unique();
此外,你可以在定義列之后創(chuàng)建索引,例如:
$table->unique('email');
你甚至可以傳遞列名數(shù)組到索引方法來創(chuàng)建組合索引:
$table->index(['account_id', 'created_at']);
Laravel 會自動生成合理的索引名稱,不過你也可以傳遞第二個參數(shù)到該方法用于指定索引名稱:
$table->index('email', 'unique_email');
可用索引類型
命令 | 描述 |
---|---|
$table->primary('id'); | 添加主鍵索引 |
$table->primary(['id', 'parent_id']); | 添加組合索引 |
$table->unique('email'); | 添加唯一索引 |
$table->index('state'); | 添加普通索引 |
$table->spatialIndex('location'); | 添加空間索引(不支持SQLite) |
索引長度 MySQL / MariaDB
Laravel 默認(rèn)使用 utf8mb4 字符集,支持在數(shù)據(jù)庫中存儲 emoji 表情。如果你現(xiàn)在運行的 MySQL 版本低于 5.7.7(或者低于 10.2.2 版本的 MariaDB),需要手動配置遷移命令生成的默認(rèn)字符串長度,以便 MySQL 為它們創(chuàng)建索引。你可以通過在 AppServiceProvider 中調(diào)用 Schema::defaultStringLength 方法來完成配置:
use Illuminate\Support\Facades\Schema; /** * Bootstrap any application services. * * @return void * @translator laravelacademy.org */ public function boot() { Schema::defaultStringLength(191); }
作為可選方案,你可以為數(shù)據(jù)庫啟用 innodb_large_prefix 選項,至于如何合理啟用這個選項,可以參考數(shù)據(jù)庫文檔說明。
重命名索引
要重命名一個索引,可以使用 renameIndex 方法,這個方法接收當(dāng)前索引名作為第一個參數(shù)以及修改后的索引名作為第二個參數(shù):
$table->renameIndex('from', 'to')
刪除索引
要刪除索引,必須指定索引名。默認(rèn)情況下,Laravel 自動分配適當(dāng)?shù)拿Q給索引 —— 連接表名、列名和索引類型。下面是一些例子:
命令 | 描述 |
---|---|
$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) |
如果要傳遞數(shù)據(jù)列數(shù)組到刪除索引方法,那么相應(yīng)的索引名稱將會通過數(shù)據(jù)表名、列和鍵類型來自動生成:
Schema::table('geo', function (Blueprint $table) { $table->dropIndex(['state']); // Drops index 'geo_state_index' });
外鍵約束
Laravel 還提供了創(chuàng)建外鍵約束的支持,用于在數(shù)據(jù)庫層面強制引用完整性。例如,我們在posts 表中定義了一個引用 users 表 id 列的 user_id 列:
Schema::table('posts', function (Blueprint $table) { $table->integer('user_id')->unsigned(); $table->foreign('user_id')->references('id')->on('users'); });
你還可以為約束的“on delete”和“on update”屬性指定期望的動作:
$table->foreign('user_id') ->references('id')->on('users') ->onDelete('cascade');
要刪除一個外鍵,可以使用 dropForeign 方法。外鍵約束和索引使用同樣的命名規(guī)則 —— 連接表名、外鍵名然后加上“_foreign”后綴:
$table->dropForeign('posts_user_id_foreign');
或者,你還可以傳遞在刪除時會自動使用基于慣例的約束名數(shù)值數(shù)組:
$table->dropForeign(['user_id']);
你可以在遷移時通過以下方法啟用或關(guān)閉外鍵約束:
Schema::enableForeignKeyConstraints(); Schema::disableForeignKeyConstraints();
注:由于使用外鍵風(fēng)險級聯(lián)刪除風(fēng)險較高,一般情況下我們很少使用外鍵,而是通過代碼邏輯來實現(xiàn)級聯(lián)操作。
以上就是本文的全部內(nèi)容,希望對大家的學(xué)習(xí)有所幫助,也希望大家多多支持腳本之家。
標(biāo)簽:韶關(guān) 涼山 昭通 遼陽 梅河口 九江 甘肅 十堰
巨人網(wǎng)絡(luò)通訊聲明:本文標(biāo)題《Laravel5.7 數(shù)據(jù)庫操作遷移的實現(xiàn)方法》,本文關(guān)鍵詞 Laravel5.7,數(shù)據(jù)庫,操作,遷移,;如發(fā)現(xiàn)本文內(nèi)容存在版權(quán)問題,煩請?zhí)峁┫嚓P(guān)信息告之我們,我們將及時溝通與處理。本站內(nèi)容系統(tǒng)采集于網(wǎng)絡(luò),涉及言論、版權(quán)與本站無關(guān)。