Schema Builder

Laravel 提供 Schema 類別來操作資料表。通常會用在 migration 檔案中。

建立資料表

Schema::create('posts', function($table) {
$table->increments('id');
$table->string('title');
$table->string('content');
$table->timestamps();
});

等效 SQL:

CREATE TABLE `posts` (
`id` int(10) unsigned NOT NULL AUTO_INCREMENT,
`title` varchar(255) NOT NULL DEFAULT '',
`content` varchar(255) NOT NULL DEFAULT '',
`created_at` timestamp NOT NULL DEFAULT '0000-00-00 00:00:00',
`updated_at` timestamp NOT NULL DEFAULT '0000-00-00 00:00:00',
PRIMARY KEY (`id`)
)

資料表重新命名

Schema::rename($from, $to);

範例:

Schema::rename('posts', 'articles');

等效 SQL:

ALTER TABLE `posts`
RENAME TO `articles`;

刪除資料表

Schema::drop('posts');

或

Schema::dropIfExists('posts');

等效 SQL:

DROP TABLE `posts`;

新增欄位

Schema::table('posts', function($table)
{
$table->string('tag');
});

string 會被轉換成 varchar(255)。

等效 SQL:

ALTER TABLE `posts`
ADD `tag` varchar(255);

各種指令所代表的資料型態的列表:

註:因為各家資料庫的資料型態略有不同,Schema 指令會自動轉換成符合該資料庫所使用的資料型態。

指令

說明

$table->bigIncrements('id');

做為 id 的自動遞增欄 位,相當於 "big integer" 型態

$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->decimal('amount', 5, 2);

相當於 DECIMAL 型態

$table->double('column', 15, 8);

相當於 DOUBLE 型態,15 是數值長度,8 是小數點位數

$table->enum('choices', array('foo', 'bar'));

相當於 ENUM 型態

$table->float('amount');

相當於 FLOAT 型態

$table->increments('id');

當作主鍵的自動遞增欄位,INTEGER 型態

$table->integer('votes');

相當於 INTEGER 型態

$table->longText('description');

相當於 LONGTEXT 型態

$table->mediumInteger('numbers');

相當於 MEDIUMINT 型態

$table->mediumText('description');

相當於 MEDIUMTEXT 型態

$table->nullableTimestamps();

相當於 TIMESTAMP 型態,但允許 NULL 值

$table->smallInteger('votes');

相當於 SMALLINT 型態

$table->tinyInteger('numbers');

相當於 TINYINT 型態

$table->softDeletes();

使用 deleted_at 欄位當做軟刪除的記錄欄位

$table->string('email');

相當於 VARCHAR 型態

$table->string('name', 100);

相當於 VARCHAR(100) 型態

$table->text('description');

相當於 TEXT 型態

$table->time('sunrise');

相當於 TIME 型態

$table->timestamp('added_on');

相當於 TIMESTAMP 型態

$table->timestamps();

加入 created_at 和 updated_at 欄位做為當資料[建立]及[更新]時間記錄之用

$table->rememberToken();

remember_token 欄位,相當於 VARCHAR(100) NULL 型態,儲存 session 資料

->nullable()

當該欄位允許 NULL 值時,可以串接這個方法

->default($value)

當要設定該欄位的預設值時串接使用

->unsigned()

指定 INTEGER 型態為 UNSIGNED 型態

刪除欄位

Schema::table('posts', function($table)
{
$table->dropColumn('tag');
});

等效 SQL:

ALTER TABLE `posts`
DROP COLUMN `tag`;

欄位重新命名

Schema::table('posts', function($table)
{
$table->renameColumn('from', 'to');
});

等效 SQL:

ALTER TABLE `posts`
RENAME COLUMN `from` to `to`;