1. 創(chuàng)建數(shù)據(jù)遷移
創(chuàng)建表遷移
php artisan make:migration create_users_table
--table和--create選項(xiàng)
用于指定表名以及該遷移是否要?jiǎng)?chuàng)建一個(gè)新的數(shù)據(jù)表
創(chuàng)建表
php artisan make:migration create_users_table --create=users
修改表
php artisan make:migration add_votes_to_users_table --table=users
--path選項(xiàng)
用于指定生成遷移的自定義輸出路徑
提供的路徑應(yīng)該是相對(duì)于應(yīng)用根目錄的
2. 遷移結(jié)構(gòu)
up方法:用于新增表孕锄,列或者索引到數(shù)據(jù)庫(kù)
down方法:用于刪除表绅作,列或者索引
<?php
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Database\Migrations\Migration;
class CreateFlightsTable extends Migration{
/**
* 運(yùn)行遷移
*
* @return void
*/
public function up()
{
Schema::create('flights', function (Blueprint $table) {
$table->increments('id');
$table->string('name');
$table->string('airline');
$table->timestamps();
});
}
/**
* 撤銷遷移
*
* @return void
*/
public function down()
{
Schema::drop('flights');
}
}
3. 運(yùn)行遷移
php artisan migrate
運(yùn)行應(yīng)用中所有未執(zhí)行的遷移
如果再運(yùn)行時(shí)遇到”class not found“的錯(cuò)誤提示,嘗試運(yùn)行composer dump-autoload命令然后重新運(yùn)行遷移命令澈段。
php artisan migrate --force
運(yùn)行遷移不提示信息
有些遷移操作是毀滅性的,這意味著它們可能造成數(shù)據(jù)的丟失,為了避免在生產(chǎn)環(huán)境數(shù)據(jù)庫(kù)中運(yùn)行這些命令肥照,你將會(huì)在運(yùn)行這些命令之前被提示并確認(rèn)。想要強(qiáng)制運(yùn)行這些命令而不被提示勤众,可以使用--force:
4. 回滾遷移
php artisan migrate:rollback
回滾最后一批運(yùn)行的遷移舆绎,可能包含多個(gè)遷移文件
php artisan migrate:reset
回滾所有的應(yīng)用遷移
php artisan migrate:refresh
php artisan migrate:refresh --seed
migrate:refresh命令將會(huì)先回滾所有數(shù)據(jù)庫(kù)遷移
然后運(yùn)行migrate:refresh --seed命令
這個(gè)命令可以有效的重建整個(gè)數(shù)據(jù)庫(kù)
5. 編寫遷移
- 創(chuàng)建表
使用Schema門面上的create方法來創(chuàng)建新的數(shù)據(jù)表。create方法接收兩個(gè)參數(shù)决摧,第一個(gè)是表名亿蒸,第二個(gè)是獲取用于定義新表的Blueprint對(duì)象的閉包:
Schema::create('users', function ($table) {
$table->increments('id');
});
- 檢查表列是否存在
if (Schema::hasTable('users')) {
//
}
if (Schema::hasColumn('users', 'email')) {
//
}
- 連接&存儲(chǔ)引擎
如果你想要在一個(gè)數(shù)據(jù)庫(kù)連接上執(zhí)行表結(jié)構(gòu)操作,該數(shù)據(jù)庫(kù)連接并不是默認(rèn)數(shù)據(jù)庫(kù)連接掌桩,使用connection方法
Schema::connection('foo')->create('users', function ($table) {
$table->increments('id');
});
要設(shè)置表的存儲(chǔ)引擎边锁,在表結(jié)構(gòu)構(gòu)建器上設(shè)置engine屬性:
Schema::create('users', function ($table) {
$table->engine = 'InnoDB';
$table->increments('id');
});
- 重命名/刪除 表
要重命名一個(gè)已存在的數(shù)據(jù)表,使用rename方法
Schema::rename($from, $to);
要?jiǎng)h除一個(gè)已存在的數(shù)據(jù)表波岛,可以使用drop或dropIfExists方法
Schema::drop('users');
Schema::dropIfExists('users');
- 創(chuàng)建列
要更新一個(gè)已存在的表茅坛,使用Schema門面上的table方法
和create方法一樣,table方法接收兩個(gè)參數(shù):表名和獲取用于添加列到表的Blueprint實(shí)例的閉包:
Schema::create('users', function ($table) {
$table->increments('id');
$table->string('name');
});
命令 |
描述 |
$table->bigIncrements('id'); |
自增ID则拷,類型為bigint |
$table->bigInteger('votes'); |
等同于數(shù)據(jù)庫(kù)中的BIGINT類型 |
$table->binary('data'); |
等同于數(shù)據(jù)庫(kù)中的BLOB類型 |
$table->boolean('confirmed'); |
等同于數(shù)據(jù)庫(kù)中的BOOLEAN類型 |
$table->char('name', 4); |
等同于數(shù)據(jù)庫(kù)中的CHAR類型 |
$table->date('created_at'); |
等同于數(shù)據(jù)庫(kù)中的DATE類型 |
$table->dateTime('created_at'); |
等同于數(shù)據(jù)庫(kù)中的DATETIME類型 |
$table->decimal('amount', 5, 2); |
等同于數(shù)據(jù)庫(kù)中的DECIMAL類型贡蓖,帶一個(gè)精度和范圍 |
$table->double('column', 15, 8); |
等同于數(shù)據(jù)庫(kù)中的DOUBLE類型,帶精度, 總共15位數(shù)字煌茬,小數(shù)點(diǎn)后8位 |
$table->enum('choices', ['foo', 'bar']); |
等同于數(shù)據(jù)庫(kù)中的 ENUM類型 |
$table->float('amount'); |
等同于數(shù)據(jù)庫(kù)中的 FLOAT 類型 |
$table->increments('id'); |
數(shù)據(jù)庫(kù)主鍵自增ID |
$table->integer('votes'); |
等同于數(shù)據(jù)庫(kù)中的 INTEGER 類型 |
$table->json('options'); |
等同于數(shù)據(jù)庫(kù)中的 JSON 類型 |
$table->jsonb('options'); |
等同于數(shù)據(jù)庫(kù)中的 JSONB 類型 |
$table->longText('description'); |
等同于數(shù)據(jù)庫(kù)中的 LONGTEXT 類型 |
$table->mediumInteger('numbers'); |
等同于數(shù)據(jù)庫(kù)中的 MEDIUMINT類型 |
$table->mediumText('description'); |
等同于數(shù)據(jù)庫(kù)中的 MEDIUMTEXT類型 |
$table->morphs('taggable'); |
添加一個(gè) INTEGER類型的 taggable_id 列和一個(gè) STRING類型的 taggable_type列 |
$table->nullableTimestamps(); |
和 timestamps()一樣但允許 NULL值. |
$table->rememberToken(); |
添加一個(gè) remember_token 列: VARCHAR(100) NULL. |
$table->smallInteger('votes'); |
等同于數(shù)據(jù)庫(kù)中的 SMALLINT 類型 |
$table->softDeletes(); |
新增一個(gè) deleted_at 列 用于軟刪除. |
$table->string('email'); |
等同于數(shù)據(jù)庫(kù)中的 VARCHAR 列 . |
$table->string('name', 100); |
等同于數(shù)據(jù)庫(kù)中的 VARCHAR斥铺,帶一個(gè)長(zhǎng)度 |
$table->text('description'); |
等同于數(shù)據(jù)庫(kù)中的 TEXT 類型 |
$table->time('sunrise'); |
等同于數(shù)據(jù)庫(kù)中的 TIME類型 |
$table->tinyInteger('numbers'); |
等同于數(shù)據(jù)庫(kù)中的 TINYINT 類型 |
$table->timestamp('added_on'); |
等同于數(shù)據(jù)庫(kù)中的 TIMESTAMP 類型 |
$table->timestamps(); |
添加 created_at 和 updated_at列. |
$table->uuid('id'); |
等同于數(shù)據(jù)庫(kù)的UUID |
- 列修改器
在添加列的時(shí)候還可以使用一些其它列”修改器“
將name列的尺寸從 25 增加到 50:
$table->string('name', 50)->change();
修改該列允許 NULL 值:
$table->string('name', 50)->nullable()->change();
修改該列默認(rèn)NULL:
$table->string('email')->nullable();
重命名列
注意:暫不支持 enum類型的列的重命名。
$table->renameColumn('from', 'to');
刪除列
$table->dropColumn('votes');
刪除多個(gè)列
$table->dropColumn(['votes', 'avatar', 'location']);
在從SQLite數(shù)據(jù)庫(kù)刪除列之前坛善,需要添加doctrine/dbal依賴到composer.json文件并在終端中運(yùn)行composer update命令來安裝該庫(kù)晾蜘。
修改器 |
描述 |
->first() |
將該列置為表中第一個(gè)列 (僅適用于MySQL) |
->after('column') |
將該列置于另一個(gè)列之后 (僅適用于MySQL) |
->nullable() |
允許該列的值為NULL |
->default($value) |
指定列的默認(rèn)值 |
->unsigned() |
設(shè)置 integer 列為 UNSIGNED |
- 索引
指定列值為唯一索引
$table->string('email')->unique();
定義列之后創(chuàng)建索引
$table->unique('email');
傳遞列名數(shù)組到索引方法來創(chuàng)建混合索引
$table->index(['account_id', 'created_at']);
命令 |
描述 |
$table->primary('id'); |
添加主鍵索引 |
$table->primary(['first', 'last']); |
添加混合索引 |
$table->unique('email'); |
添加唯一索引 |
$table->index('state'); |
添加普通索引 |
$table->dropPrimary('users_id_primary'); |
從 “users”表中刪除主鍵索引 |
$table->dropUnique('users_email_unique'); |
從 “users”表中刪除唯一索引 |
$table->dropIndex('geo_state_index'); |
從 “geo”表中刪除普通索引 |
- 外鍵約束
例如,我們?cè)趐osts表中定義了一個(gè)引用users表的id列的user_id列:
Schema::table('posts', function ($table) {
$table->integer('user_id')->unsigned();
$table->foreign('user_id')->references('id')->on('users');
});
你還可以為約束的“on delete”和“on update”屬性指定期望的動(dòng)作:
$table->foreign('user_id')
->references('id')->on('users')
->onDelete('cascade');
要?jiǎng)h除一個(gè)外鍵眠屎,可以使用dropForeign方法剔交。外鍵約束和索引使用同樣的命名規(guī)則——連接表名、外鍵名然后加上”_foreign”后綴:
$table->dropForeign('posts_user_id_foreign');