Thinkphp 第二章:數(shù)據(jù)創(chuàng)建和遷移

本章我們來了解下如何進行數(shù)據(jù)庫的創(chuàng)建和遷移,并著重講解了ThinkPHP5的數(shù)據(jù)庫遷移擴展的使用噪裕,學習內(nèi)容主要包括:

安裝擴展

數(shù)據(jù)遷移是一個擴展包,非核心內(nèi)置股毫,你需要首先通過composer安裝擴展(對composer還不熟悉的朋友可以看云參考官方的快速入門教程中的第一章基礎部分的框架composer安裝部分):

composer require topthink/think-migration=1.*

指定安裝1.*版本是由于最新的2.0版本只適用于5.1版本核心框架膳音。

數(shù)據(jù)遷移

數(shù)據(jù)遷移就像是數(shù)據(jù)庫的版本控制,可以確保項目團隊輕松修改并保持應用程序的數(shù)據(jù)庫結構的一致性铃诬。為了避免手動修改數(shù)據(jù)庫導致的沖突問題祭陷,應當盡量避免手動操作數(shù)據(jù)庫,ThinkPHP5.0的數(shù)據(jù)遷移擴展提供了優(yōu)雅的方式讓你編寫遷移腳本和執(zhí)行遷移趣席。

編寫數(shù)據(jù)遷移腳本是一個良好的習慣和團隊協(xié)作規(guī)范兵志,但并非強制,也不會影響本書后面的章節(jié)的學習宣肚,如果你感覺暫時用不上可以先略過想罕。

創(chuàng)建遷移腳本

使用下面的命令來創(chuàng)建一個遷移腳本:

php think migrate:create CreateUserTable

如果你對命令行和指令不熟悉,請參考快速入門系列的第一部第十章關于命令行指令的說明霉涨。

CreateUserTable 這個腳本名必須為駝峰格式按价,指令輸入完成后惭适,會在項目根目錄下的database/migrations目錄下創(chuàng)建一個遷移腳本,里面默認有一個change方法楼镐。

如果你的遷移腳本里只會有以下的操作:

  • createTable(創(chuàng)建表)
  • renameTable(重命名表)
  • addColumn(添加字段)
  • renameColumn(重命名字段)
  • addIndex(添加索引)
  • addForeignKey(添加外鍵)

那么你只需要change方法就可以了癞志,回滾的時候可以自動根據(jù)change里的操作來逆向操作,否則需要定義updown兩個方法框产,用來表示遷移回滾兩個具體的操作今阳。

定義了updown方法后就不要再定義change方法了茅信,在change方法里操作數(shù)據(jù)表的時候,最后只能使用create()或者update()來完成操作墓臭,而不能使用save()

運行遷移

php think migrate:run
// 指定版本
php think migrate:run -t 20120103083322

設置斷點

php think migrate:breakpoint

//指定版本
php think migrate:breakpoint -t 20120103083322

回滾遷移

可以回滾上一次數(shù)據(jù)遷移操作(可能包含多個遷移文件)蘸鲸。

php think migrate:rollback

//指定版本
php think migrate:rollback -t 20120103083322

//回滾所有
php think migrate:rollback -t 0

如果設置了斷點,默認最多只可以回滾到斷點處,可以使用--force參數(shù)強制回滾所有

php think migrate:rollback -t 0 -f

遷移方法

遷移腳本中支持大部分的數(shù)據(jù)庫操作的實現(xiàn)方法窿锉,我們陸續(xù)給你講述這些用法酌摇。

創(chuàng)建數(shù)據(jù)表

創(chuàng)建數(shù)據(jù)表使用create方法,并在之前調(diào)用addColumn方法相關方法進行數(shù)據(jù)字段定義:

public function change()
{
  $this->table('user')
    ->addColumn(Column::string('name')->setComment('用戶昵稱'))
    ->addColumn(Column::string('username')->setUnique()->setComment('用戶名'))
    ->addColumn(Column::string('email')->setUnique()->setComment('郵箱'))
    ->addColumn(Column::string('password')->setComment('密碼'))
    ->create();
}

addColumn方法添加字段傳入一個Column對象實例嗡载,后面會詳細介紹該對象的使用窑多。

或者使用updown

public function up()
{
  $this->table('user')
    ->addColumn(Column::string('name')->setComment('用戶昵稱'))
    ->addColumn(Column::string('username')->setUnique()->setComment('用戶名'))
    ->addColumn(Column::string('email')->setUnique()->setComment('郵箱'))
    ->addColumn(Column::string('password')->setComment('密碼'))
    ->create();
}

/**
* Down Method.
*/
public function down()
{
    $this->dropTable('user');
}

檢查數(shù)據(jù)表或字段是否存在

if($this->hasTable('user')){
    //
}
if($this->table('user')->hasColumn('username')){
    //
}

存儲引擎

$this->table('user',['engine'=>'MyISAM'])

默認為 InnoDB

設置主鍵

默認會自動添加一個id自增主鍵

$this->table('followers')
    ->setId(false) //關閉自動設置主鍵
    ->setPrimaryKey(['user_id','follower_id']) //設置聯(lián)合主鍵
     ->addColumn(Column::integer('user_id'))
    ->addColumn(Column::integer('follower_id'))
    ->create();

默認的主鍵是自增的,如果不需要自增可以如下

$this->table('followers')
    ->setId('user_id') 
    ->addColumn(Column::integer('follower_id'))
    ->create();

重命名與刪除數(shù)據(jù)表

//重命名
$this->table('user')->rename('user2');

//刪除
$this->table('user')->drop();
//或者
$this->dropTable('user');

可用字段

數(shù)據(jù)庫結構構造器包含了許多字段類型洼滚,供你構建數(shù)據(jù)表時使用:

命令 描述
Column::bigInteger('votes'); 相當于 BIGINT 型態(tài)埂息。
Column::binary('data'); 相當于 BLOB 型態(tài)。
Column::boolean('confirmed'); 相當于 BOOLEAN 型態(tài)遥巴。
Column::char('name', 4); 相當于 CHAR 型態(tài)千康,并帶有長度。
Column::date('create_time'); 相當于 DATE 型態(tài)铲掐。
Column::dateTime('create_time'); 相當于 DATETIME 型態(tài)拾弃。
Column::decimal('amount', 5, 2); 相當于 DECIMAL 型態(tài),并帶有精度與基數(shù)摆霉。
Column::enum('choices', ['foo', 'bar']); 相當于 ENUM 型態(tài)豪椿。
Column::float('amount'); 相當于 FLOAT 型態(tài)。
Column::integer('votes'); 相當于 INTEGER 型態(tài)携栋。
Column::json('options'); 相當于 JSON 型態(tài)搭盾。
Column::jsonb('options'); 相當于 JSONB 型態(tài)。
Column::longText('description'); 相當于 LONGTEXT 型態(tài)。
Column::mediumInteger('numbers'); 相當于 MEDIUMINT 型態(tài)脏毯。
Column::mediumText('description'); 相當于 MEDIUMTEXT 型態(tài)学少。
Column::smallInteger('votes'); 相當于 SMALLINT 型態(tài)站宗。
Column::string('email'); 相當于 VARCHAR 型態(tài)滋迈。
Column::string('name', 100); 相當于 VARCHAR 型態(tài)霎奢,并帶有長度。
Column::text('description'); 相當于 TEXT 型態(tài)饼灿。
Column::time('sunrise'); 相當于 TIME 型態(tài)幕侠。
Column::tinyInteger('numbers'); 相當于 TINYINT 型態(tài)。
Column::timestamp('added_on'); 相當于 TIMESTAMP 型態(tài)碍彭。
Column::uuid('id'); 相當于 UUID 型態(tài)晤硕。

字段修飾

除了上述的字段類型列表,還有一些其它的字段「修飾」庇忌,你可以將它增加到字段中舞箍。例如,若要讓字段「nullable」皆疹,那么你可以使用 setNullable 方法:

  $this->table('user')
    ->addColumn(Column::string('name')->setNullable())
    ->create();

以下列表為字段的可用修飾疏橄。

修飾 描述
->setAfter('column') 將此字段放置在其它字段「之后」(僅限 MySQL)
->setComment('my comment') 增加注釋
->setDefault($value) 為此字段指定「默認」值
->setNullable() 此字段允許寫入 NULL 值
->setUnsigned() 設置 integer 字段為 UNSIGNED

特殊字段

$this->table('user')
  ->addTimestamps() //添加create_time和update_time兩個字段
  ->addSoftDelete()  //添加delete_time字段
  ->addMorphs('taggable')  //加入整數(shù) taggable_id 與字符串 taggable_type
  ->create();

修改字段

//重命名字段
 $this->table('user')->renameColumn('old_name','new_name');

 //修改字段屬性
  $this->table('user')->changeColumn(Column::integer('votes')->setNullable());

移除字段

$this->table('user')->removeColumn('name');

創(chuàng)建索引

數(shù)據(jù)庫結構構造器支持多種類型的索引。首先略就,讓我們先來看一個示例捎迫,其指定了字段的值必須是唯一的。你可以簡單的在字段定義之后鏈式調(diào)用 setUnique 方法來創(chuàng)建索引:

  $this->table('user')
    ->addColumn(Column::string('name')->setUnique()->setNullable())
    ->create();

此外表牢,你也可以在定義完字段之后創(chuàng)建索引窄绒。例如:

  $this->table('user')
    ->addColumn(Column::string('name')->setNullable())
    ->addIndex('name',['unique'=>true])
    ->create();

你也可以傳遞一個字段的數(shù)組至索引方法來創(chuàng)建復合索引:

addIndex(['name','email'])

移除索引

 $this->table('user')->removeIndex('name');

  $this->table('user')->removeIndex(['name','email']);

外鍵約束

        $table = $this->table('tags');
        $table->addColumn(Column::integer('tag_name'))
              ->save();

 $this->table('tag_relationships')
 ->addColumn(Column::integer('tag_id'))
 ->addForeignKey('tag_id', 'tags', 'id', array('delete'=> 'SET_NULL', 'update'=> 'NO_ACTION'))
 ->save();

總結

現(xiàn)在我們已經(jīng)大概了解了數(shù)據(jù)遷移擴展的使用,沒有搞懂的話暫時無需深究崔兴,真正有機會的時候再來深入彰导,我們下一章就要開始學習查詢構造器的使用了。

上一篇:第一章:數(shù)據(jù)庫架構基礎
下一篇:第三章:查詢構造器

最后編輯于
?著作權歸作者所有,轉載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末恼布,一起剝皮案震驚了整個濱河市螺戳,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌折汞,老刑警劉巖倔幼,帶你破解...
    沈念sama閱讀 217,907評論 6 506
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異爽待,居然都是意外死亡损同,警方通過查閱死者的電腦和手機,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,987評論 3 395
  • 文/潘曉璐 我一進店門鸟款,熙熙樓的掌柜王于貴愁眉苦臉地迎上來膏燃,“玉大人,你說我怎么就攤上這事何什∽榱ǎ” “怎么了?”我有些...
    開封第一講書人閱讀 164,298評論 0 354
  • 文/不壞的土叔 我叫張陵,是天一觀的道長伶贰。 經(jīng)常有香客問我蛛砰,道長,這世上最難降的妖魔是什么黍衙? 我笑而不...
    開封第一講書人閱讀 58,586評論 1 293
  • 正文 為了忘掉前任泥畅,我火速辦了婚禮,結果婚禮上琅翻,老公的妹妹穿的比我還像新娘位仁。我一直安慰自己,他們只是感情好方椎,可當我...
    茶點故事閱讀 67,633評論 6 392
  • 文/花漫 我一把揭開白布聂抢。 她就那樣靜靜地躺著,像睡著了一般棠众。 火紅的嫁衣襯著肌膚如雪涛浙。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 51,488評論 1 302
  • 那天摄欲,我揣著相機與錄音,去河邊找鬼疮薇。 笑死胸墙,一個胖子當著我的面吹牛,可吹牛的內(nèi)容都是我干的按咒。 我是一名探鬼主播迟隅,決...
    沈念sama閱讀 40,275評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼励七!你這毒婦竟也來了智袭?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 39,176評論 0 276
  • 序言:老撾萬榮一對情侶失蹤掠抬,失蹤者是張志新(化名)和其女友劉穎吼野,沒想到半個月后,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體两波,經(jīng)...
    沈念sama閱讀 45,619評論 1 314
  • 正文 獨居荒郊野嶺守林人離奇死亡瞳步,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 37,819評論 3 336
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發(fā)現(xiàn)自己被綠了腰奋。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片单起。...
    茶點故事閱讀 39,932評論 1 348
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖劣坊,靈堂內(nèi)的尸體忽然破棺而出嘀倒,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 35,655評論 5 346
  • 正文 年R本政府宣布测蘑,位于F島的核電站灌危,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏帮寻。R本人自食惡果不足惜乍狐,卻給世界環(huán)境...
    茶點故事閱讀 41,265評論 3 329
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望固逗。 院中可真熱鬧浅蚪,春花似錦、人聲如沸烫罩。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,871評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽贝攒。三九已至盗誊,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間隘弊,已是汗流浹背哈踱。 一陣腳步聲響...
    開封第一講書人閱讀 32,994評論 1 269
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留梨熙,地道東北人开镣。 一個月前我還...
    沈念sama閱讀 48,095評論 3 370
  • 正文 我出身青樓,卻偏偏與公主長得像咽扇,于是被迫代替她去往敵國和親邪财。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 44,884評論 2 354