資料庫：遷移

bigIncrements bigInteger decimal double float id increments integer mediumIncrements mediumInteger smallIncrements smallInteger tinyIncrements tinyInteger unsignedBigInteger unsignedInteger unsignedMediumInteger unsignedSmallInteger unsignedTinyInteger

dateTime dateTimeTz date time timeTz timestamp timestamps timestampsTz softDeletes softDeletesTz year

binary

json jsonb

ulid ulidMorphs uuid uuidMorphs nullableUlidMorphs nullableUuidMorphs

空間類型

關係類型

專用類型

bigIncrements()

bigIncrements 方法創建一個自動遞增的 UNSIGNED BIGINT（主鍵）等效列：

$table->bigIncrements('id');

bigInteger()

bigInteger 方法創建一個 BIGINT 等效列：

$table->bigInteger('votes');

binary()

binary 方法創建一個 BLOB 等效列：

$table->binary('photo');

在使用 MySQL、MariaDB 或 SQL Server 時，您可以傳遞 length 和 fixed 參數來創建 VARBINARY 或 BINARY 等效列：

$table->binary('data', length: 16); // VARBINARY(16)

$table->binary('data', length: 16, fixed: true); // BINARY(16)

boolean()

boolean 方法創建一個 BOOLEAN 等效列：

$table->boolean('confirmed');

char()

char 方法創建一個指定長度的 CHAR 等效列：

$table->char('name', length: 100);

dateTimeTz()

dateTimeTz 方法創建具有可選小數秒精度的帶時區的 DATETIME 等效列：

$table->dateTimeTz('created_at', precision: 0);

dateTime()

dateTime 方法創建具有可選小數秒精度的 DATETIME 等效列：

$table->dateTime('created_at', precision: 0);

date()

date 方法創建 DATE 等效列：

$table->date('created_at');

decimal()

decimal 方法創建具有給定精度（總位數）和比例（小數位數）的 DECIMAL 等效列：

$table->decimal('amount', total: 8, places: 2);

double()

double 方法創建 DOUBLE 等效列：

$table->double('amount');

enum()

enum 方法創建具有給定有效值的 ENUM 等效列：

$table->enum('difficulty', ['easy', 'hard']);

float()

float 方法創建具有給定精度的 FLOAT 等效列：

$table->float('amount', precision: 53);

foreignId()

foreignId 方法創建一個 UNSIGNED BIGINT 等效列：

$table->foreignId('user_id');

foreignIdFor()

foreignIdFor 方法為給定的模型類添加一個 {column}_id 等效列。該列類型將是 UNSIGNED BIGINT、CHAR(36) 或 CHAR(26)，具體取決於模型鍵類型：

$table->foreignIdFor(User::class);

foreignUlid()

foreignUlid 方法創建一個等效的 ULID 欄位：

$table->foreignUlid('user_id');

foreignUuid()

foreignUuid 方法創建一個等效的 UUID 欄位：

$table->foreignUuid('user_id');

geography()

geography 方法使用給定的空間類型和 SRID（空間參考系統標識符）創建一個等效的 GEOGRAPHY 欄位：

$table->geography('coordinates', subtype: 'point', srid: 4326);

> [!NOTE]
> 空間類型的支援取決於您的資料庫驅動程式。請參考您資料庫的文件。如果您的應用程式使用 PostgreSQL 資料庫，您必須在使用 geography 方法之前安裝 PostGIS 擴充功能。

geometry()

geometry 方法使用給定的空間類型和 SRID（空間參考系統標識符）創建一個等效的 GEOMETRY 欄位：

$table->geometry('positions', subtype: 'point', srid: 0);

> [!NOTE]
> 空間類型的支援取決於您的資料庫驅動程式。請參考您資料庫的文件。如果您的應用程式使用 PostgreSQL 資料庫，您必須在使用 geometry 方法之前安裝 PostGIS 擴充功能。

id()

id 方法是 bigIncrements 方法的別名。預設情況下，該方法將創建一個 id 欄位；但是，如果您想要為欄位指定不同的名稱，則可以傳遞一個欄位名稱：

$table->id();

increments()

increments 方法創建一個自動遞增的 UNSIGNED INTEGER 等效欄位作為主鍵：

$table->increments('id');

integer()

integer 方法創建一個 INTEGER 等效的欄位：

$table->integer('votes');

ipAddress()

ipAddress 方法創建一個 VARCHAR 等效的欄位：

$table->ipAddress('visitor');

在使用 PostgreSQL 時，將創建一個 INET 欄位。

json()

json 方法創建一個 JSON 等效的欄位：

$table->json('options');

在使用 SQLite 時，將創建一個 TEXT 欄位。

jsonb()

jsonb 方法創建一個 JSONB 等效的欄位：

$table->jsonb('options');

在使用 SQLite 時，將創建一個 TEXT 欄位。

longText()

longText 方法創建一個 LONGTEXT 等效的欄位：

$table->longText('description');

在使用 MySQL 或 MariaDB 時，您可以將 binary 字元集應用於欄位，以創建一個 LONGBLOB 等效的欄位：

$table->longText('data')->charset('binary'); // LONGBLOB

macAddress()

macAddress 方法創建一個用於保存 MAC 地址的欄位。某些資料庫系統（如 PostgreSQL）具有專用的欄位類型來保存此類型的資料。其他資料庫系統將使用等效的字串欄位：

$table->macAddress('device');

mediumIncrements()

mediumIncrements 方法創建一個自動遞增的 UNSIGNED MEDIUMINT 等效的主鍵欄位：

$table->mediumIncrements('id');

mediumInteger()

mediumInteger 方法創建一個 MEDIUMINT 等效的欄位：

$table->mediumInteger('votes');

mediumText()

mediumText 方法創建一個 MEDIUMTEXT 等效的欄位：

$table->mediumText('description');

在使用 MySQL 或 MariaDB 時，您可以將二進制字符集應用於欄位，以創建一個 MEDIUMBLOB 等效的欄位：

$table->mediumText('data')->charset('binary'); // MEDIUMBLOB

morphs()

morphs 方法是一個方便的方法，它添加了一個 {column}_id 等效的欄位和一個 {column}_type VARCHAR 等效的欄位。{column}_id 的欄位類型將是 UNSIGNED BIGINT、CHAR(36) 或 CHAR(26)，具體取決於模型鍵類型。

當定義多態 Eloquent 關聯 所需的欄位時，可以使用此方法。在下面的示例中，將創建 taggable_id 和 taggable_type 欄位：

$table->morphs('taggable');

nullableMorphs()

此方法類似於 morphs 方法；但是，創建的欄位將是“可為空”：

$table->nullableMorphs('taggable');

nullableUlidMorphs()

此方法類似於 ulidMorphs 方法；但是，創建的欄位將是“可為空”：

$table->nullableUlidMorphs('taggable');

nullableUuidMorphs()

此方法類似於 uuidMorphs 方法；但是，創建的欄位將是“可為空”：

$table->nullableUuidMorphs('taggable');

rememberToken()

rememberToken 方法創建一個可為空的 VARCHAR(100) 等效的欄位，用於存儲當前的“記住我” 身份驗證標記：

```php
$table->rememberToken();

set()

set 方法使用給定的有效值列表創建 SET 等效的列：

$table->set('flavors', ['strawberry', 'vanilla']);

smallIncrements()

smallIncrements 方法創建一個自動增量的 UNSIGNED SMALLINT 等效列作為主鍵：

$table->smallIncrements('id');

smallInteger()

smallInteger 方法創建一個 SMALLINT 等效列：

$table->smallInteger('votes');

softDeletesTz()

softDeletesTz 方法添加一個可為空的帶有時區的 deleted_at TIMESTAMP 等效列，可選擇性地具有小數秒精度。 這個列旨在存儲 Eloquent 的 "軟刪除" 功能所需的 deleted_at 時間戳：

$table->softDeletesTz('deleted_at', precision: 0);

softDeletes()

softDeletes 方法添加一個可為空的 deleted_at TIMESTAMP 等效列，可選擇性地具有小數秒精度。 這個列旨在存儲 Eloquent 的 "軟刪除" 功能所需的 deleted_at 時間戳：

$table->softDeletes('deleted_at', precision: 0);

string()

string 方法創建給定長度的 VARCHAR 等效列：

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

text()

text 方法創建一個 TEXT 等效列：

$table->text('description');

在使用 MySQL 或 MariaDB 時，您可以將 binary 字符集應用於列，以創建一個 BLOB 等效列：

$table->text('data')->charset('binary'); // BLOB

timeTz()

timeTz 方法創建具有可選小數秒精度的帶時區的 TIME 等效列：

$table->timeTz('sunrise', precision: 0);

time()

time 方法創建具有可選小數秒精度的 TIME 等效列：

$table->time('sunrise', precision: 0);

timestampTz()

timestampTz 方法創建具有可選小數秒精度的帶時區的 TIMESTAMP 等效列：

$table->timestampTz('added_at', precision: 0);

timestamp()

timestamp 方法創建具有可選小數秒精度的 TIMESTAMP 等效列：

$table->timestamp('added_at', precision: 0);

timestampsTz()

timestampsTz 方法創建具有可選小數秒精度的 created_at 和 updated_at 帶時區的 TIMESTAMP 等效列：

$table->timestampsTz(precision: 0);

timestamps()

timestamps 方法創建具有可選小數秒精度的 created_at 和 updated_at 的 TIMESTAMP 等效列：

$table->timestamps(precision: 0);

tinyIncrements()

tinyIncrements 方法創建自動增量的 UNSIGNED TINYINT 等效列作為主鍵：

$table->tinyIncrements('id');

tinyInteger()

tinyInteger 方法創建 TINYINT 等效列：

$table->tinyInteger('votes');

tinyText()

tinyText 方法創建一個 TINYTEXT 等效的欄位：

$table->tinyText('notes');

在使用 MySQL 或 MariaDB 時，您可以將 binary 字元集應用於欄位，以創建一個 TINYBLOB 等效的欄位：

$table->tinyText('data')->charset('binary'); // TINYBLOB

unsignedBigInteger()

unsignedBigInteger 方法創建一個 UNSIGNED BIGINT 等效的欄位：

$table->unsignedBigInteger('votes');

unsignedInteger()

unsignedInteger 方法創建一個 UNSIGNED INTEGER 等效的欄位：

$table->unsignedInteger('votes');

unsignedMediumInteger()

unsignedMediumInteger 方法創建一個 UNSIGNED MEDIUMINT 等效的欄位：

$table->unsignedMediumInteger('votes');

unsignedSmallInteger()

unsignedSmallInteger 方法創建一個 UNSIGNED SMALLINT 等效的欄位：

$table->unsignedSmallInteger('votes');

unsignedTinyInteger()

unsignedTinyInteger 方法創建一個 UNSIGNED TINYINT 等效的欄位：

$table->unsignedTinyInteger('votes');

ulidMorphs()

ulidMorphs 方法是一個方便的方法，它添加了一個 {column}_id CHAR(26) 等效的欄位和一個 {column}_type VARCHAR 等效的欄位。

此方法旨在在定義需要使用 ULID 識別符的多態 Eloquent 關係 所需的欄位時使用。在下面的示例中，將創建 taggable_id 和 taggable_type 欄位：

$table->ulidMorphs('taggable');

uuidMorphs()

uuidMorphs 方法是一個方便的方法，它會新增一個 {column}_id CHAR(36) 等效的欄位和一個 {column}_type VARCHAR 等效的欄位。

這個方法旨在在定義需要使用 UUID 識別符的多態 Eloquent 關聯 所需的欄位時使用。在下面的示例中，將創建 taggable_id 和 taggable_type 欄位：

$table->uuidMorphs('taggable');

ulid()

ulid 方法創建一個 ULID 等效的欄位：

$table->ulid('id');

uuid()

uuid 方法創建一個 UUID 等效的欄位：

$table->uuid('id');

vector()

vector 方法創建一個 vector 等效的欄位：

$table->vector('embedding', dimensions: 100);

year()

year 方法創建一個 YEAR 等效的欄位：

$table->year('birth_year');

欄位修飾符

除了上面列出的欄位類型外，在將欄位添加到資料庫表時，您可以使用幾個欄位“修飾符”。例如，要使欄位“可為空”，您可以使用 nullable 方法：

use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

Schema::table('users', function (Blueprint $table) {
    $table->string('email')->nullable();
});

以下表格包含所有可用的欄位修飾符。此列表不包括 索引修飾符：