Laravel 4 入門

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`;