> For the complete documentation index, see [llms.txt](https://tony915.gitbook.io/laravel-4-2/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tony915.gitbook.io/laravel-4-2/database/schema-builder.md).

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