Giới thiệu

Migration giống như là một version control cho cơ sở dữ liệu, cho phép team của bạn định nghĩa và chia sẻ các định nghĩa database schema của application. Nếu bạn đã từng phải nói với các thành viên trong team của bạn là tự thêm một cột vào database schema ở local của họ sau khi họ lấy code mới về, thì bạn đã từng gặp phải vấn đề về migration cơ sở dữ liệu.

Laravel facade Schema cung cấp một cách để tạo và thao tác với các bảng trên tất cả các hệ thống cơ sở dữ liệu được hỗ trợ bởi Laravel mà không cần quan tâm về loại database. Thông thường, migration sẽ sử dụng facade này để tạo và sửa các bảng và các cột trong cơ sở dữ liệu.

Tạo Migration

Bạn có thể sử dụng lệnh Artisan make:migration để tạo ra một file migration cơ sở dữ liệu mới. Migration mới này sẽ được lưu trong thư mục database/migrations của bạn. Mỗi tên file migration sẽ chứa một timestamp cho phép Laravel xác định thứ tự chạy migration:

php artisan make:migration create_flights_table

Laravel sẽ sử dụng tên của migration để cố gắng đoán ra tên của bảng và liệu migration đó có tạo ra bảng mới hay không. Nếu Laravel xác định được tên bảng từ tên migration, thì Laravel sẽ khai báo trước tên bảng vào file migration đã tạo. Nếu như không xác định được, bạn có thể phải chỉ định tên bảng vào trong file migration.

Nếu bạn muốn chỉ định một path riêng cho migration được tạo ra, bạn có thể sử dụng tùy chọn --path khi chạy lệnh make:migration. Path được chỉ định phải bắt đầu từ path base của ứng dụng của bạn tạo ra.

[!NOTE] Các stub của migration có thể được tùy chỉnh bằng cách sử dụng export stub

Dồn Migration

Khi bạn xây dựng ứng dụng của bạn, bạn có thể bị tích tụ ngày càng nhiều file migration theo thời gian. Điều này có thể khiến thư mục database/migrations của bạn trở nên quá tải với hàng trăm file migration. Nếu muốn, bạn có thể "dồn" migration của bạn vào một file SQL. Để bắt đầu, hãy chạy lệnh schema:dump:

php artisan schema:dump

# Dump the current database schema and prune all existing migrations...
php artisan schema:dump --prune

Khi bạn chạy lệnh này, Laravel sẽ ghi ra một file "schema" vào thư mục database/schema trong ứng dụng của bạn. Tên file schema sẽ tương ứng với kết nối cơ sở dữ liệu. Bây giờ, khi bạn chạy migrate cơ sở dữ liệu của bạn mà chưa chạy file migration nào khác, thì Laravel sẽ chạy đầu tiên là các câu lệnh SQL trong file schema kết nối cơ sở dữ liệu mà bạn đang sử dụng. Sau khi chạy xong các câu lệnh của file SQL schema, Laravel sẽ chạy tiếp các file migrate còn lại mà không có trong schema dump.

Nếu các bài kiểm tra của ứng dụng của bạn sử dụng kết nối cơ sở dữ liệu nào khác, khác với kết nối mà bạn thường sử dụng trong quá trình phát triển ở local, bạn nên đảm bảo là bạn đã dump một file schema bằng kết nối cơ sở dữ liệu đó để các bài kiểm tra của bạn có thể build cơ sở dữ liệu của bạn. Bạn có thể muốn thực hiện việc này sau khi dump kết nối cơ sở dữ liệu mà bạn thường sử dụng trong quá trình phát triển ở local:

php artisan schema:dump
php artisan schema:dump --database=testing --prune

Bạn nên commit file schema của cơ sở dữ liệu của bạn vào trong source control để các nhà phát triển mới khác ở trong team của bạn có thể nhanh chóng tạo ra cơ sở dữ liệu cho ứng dụng của bạn.

[!WARNING] Tính năng dồn migration này, hiện tại sẽ chỉ có khả dụng cho cơ sở dữ liệu MariaDB, MySQL, PostgreSQL và SQLite, sử dụng command-line của cơ sở dữ liệu bên phía client.

Cấu trúc Migration

Một class migration sẽ chứa hai phương thức: up và down. Phương thức up sẽ được sử dụng để thêm một bảng, một cột hoặc một index mới vào cơ sở dữ liệu của bạn, trong khi phương thức down sẽ quay ngược lại các hành động mà được thực hiện bởi phương thức up.

Trong cả hai phương thức này, bạn đều có thể sử dụng schema builder của Laravel để tạo và sửa các bảng một cách rõ ràng. Để tìm hiểu về tất cả các phương thức có sẵn trong Schema builder, hãy xem tài liệu về nó. Ví dụ, migration ở dưới sẽ tạo ra một bảng flights:

<?php

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

return new class extends Migration
{
    /**
     * Run the migrations.
     */
    public function up(): void
    {
        Schema::create('flights', function (Blueprint $table) {
            $table->id();
            $table->string('name');
            $table->string('airline');
            $table->timestamps();
        });
    }

    /**
     * Reverse the migrations.
     */
    public function down(): void
    {
        Schema::drop('flights');
    }
};

Setting The Migration Connection

Nếu migration của bạn tương tác với một kết nối cơ sở dữ liệu mà không phải là kết nối cơ sở dữ liệu mặc định của ứng dụng, bạn nên set thuộc tính $connection cho migration của bạn:

/**
 * The database connection that should be used by the migration.
 *
 * @var string
 */
protected $connection = 'pgsql';

/**
 * Run the migrations.
 */
public function up(): void
{
    // ...
}

Skipping Migrations

Thỉnh thoảng một migration có thể được dùng để hỗ trợ một tính năng chưa được kích hoạt và bạn không muốn nó chạy ngay tại thời điểm hiện tại. Trong trường hợp này, bạn có thể định nghĩa một phương thức shouldRun trong migration. Nếu phương thức shouldRun trả về false, migration sẽ bị bỏ qua:

use App\Models\Flight;
use Laravel\Pennant\Feature;

/**
 * Determine if this migration should run.
 */
public function shouldRun(): bool
{
    return Feature::active(Flight::class);
}

Chạy Migration

Để chạy tất cả các migration của bạn, hãy chạy lệnh Artisan migrate:

php artisan migrate

Nếu bạn muốn xem những file migration nào đã chạy và những file nào đang chờ, bạn có thể sử dụng lệnh Artisan migrate:status:

php artisan migrate:status

Nếu bạn cung cấp tùy chọn --step cho lệnh migrate, lệnh này sẽ chạy mỗi migration dưới dạng một batch riêng, cho phép bạn rollback từng migration bằng lệnh migrate:rollback:

php artisan migrate --step

Nếu bạn muốn xem các câu lệnh SQL sẽ được chạy bởi lệnh migration trước khi thực sự chạy chúng, bạn có thể cung cấp flag --pretend cho lệnh migrate:

php artisan migrate --pretend

Isolating Migration Execution

Nếu bạn đang deploy ứng dụng của bạn trên nhiều máy chủ và chạy migration như một phần của quy trình deploy, bạn có thể không muốn hai máy chủ cùng chạy migration cơ sở dữ liệu cùng một lúc. Để tránh điều này, bạn có thể sử dụng tùy chọn isolated khi gọi lệnh migrate.

Khi tùy chọn isolated được cung cấp, Laravel sẽ lấy khóa atomic bằng driver bộ nhớ cache của ứng dụng trước khi thử chạy lệnh migration của bạn. Mọi nỗ lực khác để chạy lệnh migrate trong khi khóa đó đang được giữ sẽ không thành công; tuy nhiên, lệnh vẫn sẽ hiển thị với mã trạng thái thành công:

php artisan migrate --isolated

[!WARNING] Để sử dụng tính năng này, ứng dụng của bạn phải sử dụng driver cache memcached, redis, dynamodb, database, file hoặc array làm driver cache mặc định cho ứng dụng của bạn. Ngoài ra, tất cả các server phải giao tiếp cùng với một server cache trung tâm.

Forcing Migrations To Run In Production

Một số hành động migration có thể là nguy hiểm, có nghĩa là chúng có thể khiến bạn mất dữ liệu. Để bảo vệ bạn khỏi việc chạy các lệnh này đối với cơ sở dữ liệu production, bạn sẽ được nhắc xác nhận trước khi chạy các lệnh được này. Để bắt các lệnh này chạy mà không nhắc xác nhận, hãy sử dụng cờ --force:

php artisan migrate --force

Rollback Migration

Để rollback về migration mới nhất, bạn có thể sử dụng lệnh Artisan rollback. Lệnh này sẽ rollback lại "batch" migration cuối cùng mà bạn dùng, nó có thể có chứa nhiều file migration:

php artisan migrate:rollback

Bạn có thể muốn rollback lại một số migration cần thiết bằng cách cung cấp thêm tùy chọn step cho lệnh rollback. Ví dụ: lệnh sau sẽ rollback lại năm lần trước khi đến batch cuối cùng:

php artisan migrate:rollback --step=5

Bạn có thể roll back lại một "batch" migrations cụ thể bằng cách cung cấp tùy chọn batch cho lệnh rollback, trong đó tùy chọn batch tương ứng với giá trị batch trong bảng cơ sở dữ liệu migrations của ứng dụng. Ví dụ, lệnh sau sẽ roll back lại tất cả các migrations trong batch thứ ba:

php artisan migrate:rollback --batch=3

Nếu bạn muốn xem các câu lệnh SQL sẽ được thực thi bởi quá trình migration mà không muốn chạy chúng, bạn có thể cung cấp flag --pretend cho lệnh migrate:rollback:

php artisan migrate:rollback --pretend

Lệnh migrate:reset sẽ rollback lại tất cả các migration của application của bạn:

php artisan migrate:reset

Roll Back và Migrate Using A Single Command

Lệnh migrate:refresh sẽ rollback lại tất cả các migration của bạn và sau đó thực hiện lại lệnh migrate. Lệnh này sẽ tạo lại toàn bộ cơ sở dữ liệu của bạn:

php artisan migrate:refresh

# Refresh the database and run all database seeds...
php artisan migrate:refresh --seed

Bạn có thể rollback và migrate lại một số migration cần thiết bằng cách cung cấp tùy chọn step cho lệnh refresh. Ví dụ: lệnh sau sẽ rollback và migrate lại năm lần trước so với migration gần nhất:

php artisan migrate:refresh --step=5

Drop All Tables và Migrate

Lệnh migrate:fresh sẽ xóa tất cả các bảng ra khỏi cơ sở dữ liệu và sau đó thực thi lại lệnh migrate:

php artisan migrate:fresh

php artisan migrate:fresh --seed

Mặc định, lệnh migrate:fresh sẽ chỉ xóa các bảng khỏi kết nối cơ sở dữ liệu mặc định. Tuy nhiên, bạn có thể sử dụng tùy chọn --database để chỉ định kết nối cơ sở dữ liệu nào sẽ cần migration. Tên kết nối cơ sở dữ liệu phải tương ứng với kết nối được định nghĩa trong file cấu hình database của ứng dụng:

php artisan migrate:fresh --database=admin

[!WARNING] Lệnh migrate:fresh sẽ xoá tất cả các bảng cơ sở dữ liệu bất kể prefix của chúng là gì. Lệnh này nên được sử dụng thận trọng khi đang phát triển trên những cơ sở dữ liệu mà nó được chia sẻ với các ứng dụng khác.

Table

Tạo Tables

Để tạo một bảng cơ sở dữ liệu mới, hãy sử dụng phương thức create trên facade Schema. Phương thức create chấp nhận hai tham số: tham số đầu tiên là tên của bảng, trong khi tham số thứ hai là một closure nhận vào một đối tượng Blueprint có thể được sử dụng để định nghĩa một bảng mới:

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

Schema::create('users', function (Blueprint $table) {
    $table->id();
    $table->string('name');
    $table->string('email');
    $table->timestamps();
});

Khi tạo bảng, bạn có thể sử dụng bất kỳ column methods nào của schema builder để định nghĩa các cột của bảng.

Determining Table / Column Existence

Bạn có thể xác định sự tồn tại của một bảng, một cột, hoặc một index bằng các phương thức hasTable, hasColumn, và hasIndex:

if (Schema::hasTable('users')) {
    // The "users" table exists...
}

if (Schema::hasColumn('users', 'email')) {
    // The "users" table exists and has an "email" column...
}

if (Schema::hasIndex('users', ['email'], 'unique')) {
    // The "users" table exists and has a unique index on the "email" column...
}

Database Connection và Table Options

Nếu bạn muốn thực hiện một schema trên một kết nối cơ sở dữ liệu không phải là kết nối mặc định của application của bạn, hãy sử dụng phương thức connection:

Schema::connection('sqlite')->create('users', function (Blueprint $table) {
    $table->id();
});

Ngoài ra, có một số thuộc tính và phương thức khác có thể được sử dụng để định nghĩa các khía cạnh khác của việc tạo bảng. Thuộc tính engine có thể được sử dụng để chỉ định storage engine của bảng đó khi sử dụng MariaDB hoặc MySQL:

Schema::create('users', function (Blueprint $table) {
    $table->engine('InnoDB');

    // ...
});

Thuộc tính charset và collation có thể được sử dụng để chỉ định character set và collation cho bảng được tạo khi sử dụng MariaDB hoặc MySQL:

Schema::create('users', function (Blueprint $table) {
    $table->charset('utf8mb4');
    $table->collation('utf8mb4_unicode_ci');

    // ...
});

Phương thức temporary có thể được sử dụng để chỉ ra rằng bảng này sẽ phải là "temporary". Các bảng temporary này chỉ hiển thị trong session kết nối cơ sở dữ liệu hiện tại và sẽ tự động bị xoá đi khi kết nối bị đóng:

Schema::create('calculations', function (Blueprint $table) {
    $table->temporary();

    // ...
});

Nếu bạn muốn thêm một "comment" vào bảng cơ sở dữ liệu, bạn có thể gọi phương thức comment trên instance table. Comment trên table hiện chỉ được hỗ trợ trong MariaDB, MySQL, và PostgreSQL:

Schema::create('calculations', function (Blueprint $table) {
    $table->comment('Business calculations');

    // ...
});

Cập nhật Tables

Phương thức table trên facade Schema có thể được sử dụng để cập nhật các bảng hiện có. Giống như phương thức create, phương thức table sẽ chấp nhận hai tham số: một là tên của bảng hiện tại và một là một closure nhận vào một instance Blueprint mà bạn có thể sử dụng để thêm cột hoặc index vào bảng:

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

Schema::table('users', function (Blueprint $table) {
    $table->integer('votes');
});

Đổi tên / Xoá Table

Để đổi tên một bảng đã tồn tại trong cơ sở dữ liệu, hãy sử dụng phương thức rename:

use Illuminate\Support\Facades\Schema;

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

Để xóa một bảng hiện có, bạn có thể sử dụng các phương thức drop hoặc dropIfExists:

Schema::drop('users');

Schema::dropIfExists('users');

Renaming Tables With Foreign Keys

Trước khi đổi tên một bảng, bạn nên kiểm tra khóa ngoại trỏ đến bảng đó đã có trong file migration thay vì để Laravel tự gán tên dựa trên quy ước của nó. Nếu không, tên khóa ngoại đó sẽ tham chiếu đến tên bảng cũ.

Column

Tạo Column

Phương thức table trên facade Schema có thể được sử dụng để cập nhật các bảng đã tồn tại. Giống như phương thức create, phương thức table chấp nhận hai tham số: một là tên một bảng và hai là một closure nhận vào một instance Illuminate\Database\Schema\Blueprint mà bạn có thể sử dụng nó để thêm các cột vào trong bảng:

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

Schema::table('users', function (Blueprint $table) {
    $table->integer('votes');
});

Các loại Column có sẵn

Schema builder blueprint cung cấp nhiều phương thức tương ứng với các loại cột khác nhau mà bạn có thể thêm vào bảng cơ sở dữ liệu của bạn. Các phương thức có sẵn sẽ được liệt kê trong bảng dưới đây:

Boolean Types

String & Text Types

Numeric Types

Date & Time Types

Binary Types

Object & Json Types

UUID & ULID Types

Spatial Types

Relationship Types

Specialty Types

bigIncrements()

Phương thức bigIncrements sẽ tạo một cột tương ứng với UNSIGNED BIGINT (khóa chính) sẽ tự động tăng:

$table->bigIncrements('id');

bigInteger()

Phương thức bigInteger sẽ tạo một cột tương ứng với BIGINT:

$table->bigInteger('votes');

binary()

Phương thức binary sẽ tạo một cột tương ứng với BLOB:

$table->binary('photo');

Khi sử dụng MySQL, MariaDB hoặc SQL Server, bạn có thể truyền các tham số length và fixed để tạo ra các cột tương đương VARBINARY hoặc BINARY:

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

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

boolean()

Phương thức boolean sẽ tạo một cột tương ứng với BOOLEAN:

$table->boolean('confirmed');

char()

Phương thức char sẽ tạo một một cột tương ứng với CHAR và độ dài nhất định:

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

dateTimeTz()

Phương thức dateTimeTz sẽ tạo một cột tương ứng với DATETIME (cùng timezone) với một tùy chọn độ chính xác của giây tính đến hàng phân số phía sau dấu chấm:

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

dateTime()

Phương thức dateTime sẽ tạo một cột tương ứng với DATETIME và một tùy chọn độ chính xác của giây tính đến hàng phân số phía sau dấu chấm:

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

date()

Phương thức date sẽ tạo một cột tương ứng với DATE:

$table->date('created_at');

decimal()

Phương thức decimal sẽ tạo một cột tương ứng với DECIMAL và độ chính xác (tổng chữ số) và độ dài (chữ số thập phân):

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

double()

Phương thức double sẽ tạo một cột tương ứng với DOUBLE:

$table->double('amount');

enum()

Phương thức enum sẽ tạo một cột tương ứng với ENUM và các giá trị hợp lệ:

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

Tất nhiên, bạn có thể sử dụng phương thức Enum::cases() thay vì tự định nghĩa một mảng các giá trị hợp lệ:

use App\Enums\Difficulty;

$table->enum('difficulty', Difficulty::cases());

float()

Phương thức float sẽ tạo một cột tương ứng với FLOAT và độ chính xác:

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

foreignId()

Phương thức foreignId sẽ tạo một cột tương ứng với UNSIGNED BIGINT:

$table->foreignId('user_id');

foreignIdFor()

Phương thức foreignIdFor sẽ thêm một cột tương ứng với {column}_id cho một model class. Kiểu cột sẽ là UNSIGNED BIGINT, CHAR(36) hoặc CHAR(26) tùy thuộc vào kiểu khóa model:

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

foreignUlid()

Phương thức foreignUlid sẽ tạo ra một cột tương ứng với ULID:

$table->foreignUlid('user_id');

foreignUuid()

Phương thức foreignUuid sẽ tạo một cột tương ứng với UUID:

$table->foreignUuid('user_id');

geography()

Phương thức geography sẽ tạo một cột tương ứng với GEOGRAPHY với kiểu không gian và SRID (Spatial Reference System Identifier) đã cho:

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

[!NOTE] Việc hỗ trợ cho các kiểu dữ liệu không gian phụ thuộc vào driver cơ sở dữ liệu của bạn. Vui lòng tham khảo tài liệu của cơ sở dữ liệu của bạn. Nếu ứng dụng của bạn đang sử dụng cơ sở dữ liệu PostgreSQL, bạn phải cài đặt extension PostGIS trước khi có thể sử dụng phương thức geography.

geometry()

Phương thức geometry sẽ tạo một cột tương ứng với GEOMETRY với kiểu không gian và SRID (Spatial Reference System Identifier) đã cho:

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

[!NOTE] Việc hỗ trợ cho các kiểu dữ liệu không gian phụ thuộc vào driver cơ sở dữ liệu của bạn. Vui lòng tham khảo tài liệu của cơ sở dữ liệu của bạn. Nếu ứng dụng của bạn đang sử dụng cơ sở dữ liệu PostgreSQL, bạn phải cài đặt extension PostGIS trước khi có thể sử dụng phương thức geometry.

id()

Phương thức id là lối tắt của phương thức bigIncrements. Mặc định, phương thức sẽ tạo một cột id; tuy nhiên, bạn có thể truyền vào tên của cột nếu bạn muốn gán một tên khác cho cột:

$table->id();

increments()

Phương thức increments sẽ tạo một cột tương ứng với UNSIGNED INTEGER tự động tăng làm khóa chính:

$table->increments('id');

integer()

Phương thức integer sẽ tạo một cột tương ứng với INTEGER:

$table->integer('votes');

ipAddress()

Phương thức ipAddress sẽ tạo một cột tương ứng với VARCHAR:

$table->ipAddress('visitor');

Khi sử dụng PostgreSQL, cột INET sẽ được tạo.

json()

Phương thức json sẽ tạo một cột tương ứng với JSON:

$table->json('options');

Khi sử dụng SQLite, một cột TEXT sẽ được tạo.

jsonb()

Phương thức jsonb sẽ tạo một cột tương ứng với JSONB:

$table->jsonb('options');

Khi sử dụng SQLite, một cột TEXT sẽ được tạo.

longText()

Phương thức longText sẽ tạo một cột tương ứng với LONGTEXT:

$table->longText('description');

Khi sử dụng MySQL hoặc MariaDB, bạn có thể áp dụng bộ ký tự binary cho cột để tạo ra một cột tương đương LONGBLOB:

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

macAddress()

Phương thức macAddress sẽ tạo một cột dùng để chứa địa chỉ MAC. Một số hệ thống cơ sở dữ liệu, chẳng hạn như PostgreSQL, có một loại cột chuyên biệt cho loại dữ liệu này. Các hệ thống cơ sở dữ liệu khác sẽ sử dụng cột tương ứng với string:

$table->macAddress('device');

mediumIncrements()

Phương thức mediumIncrements sẽ tạo một cột tương ứng với UNSIGNED MEDIUMINT tự động tăng làm khóa chính:

$table->mediumIncrements('id');

mediumInteger()

Phương thức mediumInteger sẽ tạo một cột tương ứng với MEDIUMINT:

$table->mediumInteger('votes');

mediumText()

Phương thức mediumText sẽ tạo một cột tương ứng với MEDIUMTEXT:

$table->mediumText('description');

Khi sử dụng MySQL hoặc MariaDB, bạn có thể áp dụng bộ ký tự binary cho cột để tạo ra một cột tương đương MEDIUMBLOB:

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

morphs()

Phương thức morphs là một phương thức rất tiện lợi, nó sẽ thêm một cột tương ứng với {column}_id và một cột khác là {column}_type VARCHAR. Kiểu cột cho {column}_id sẽ là UNSIGNED BIGINT, CHAR(36) hoặc CHAR(26) tùy thuộc vào kiểu khóa của model.

Mục đích phương thức này là nhằm sử dụng khi định nghĩa các cột cần thiết cho quan hệ đa hình. Trong ví dụ dưới, các cột taggable_id và taggable_type sẽ được tạo:

$table->morphs('taggable');

nullableMorphs()

Phương thức này tương tự như phương thức morphs; tuy nhiên, các cột được tạo sẽ có giá trị "nullable":

$table->nullableMorphs('taggable');

nullableUlidMorphs()

Phương thức này tương tự như phương thức ulidMorphs; tuy nhiên, các cột được tạo sẽ có giá trị "nullable":

$table->nullableUlidMorphs('taggable');

nullableUuidMorphs()

Phương thức này tương tự như phương thức uuidMorphs; tuy nhiên, các cột được tạo sẽ có giá trị "nullable":

$table->nullableUuidMorphs('taggable');

rememberToken()

Phương thức rememberToken sẽ tạo một cột tương ứng với VARCHAR(100) và có thể nullable, dùng để lưu trữ chức năng "remember me" authentication token:

$table->rememberToken();

set()

Phương thức set sẽ tạo một cột tương ứng với SET và một danh sách các giá trị hợp lệ:

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

smallIncrements()

Phương thức smallIncrements sẽ tạo một cột tương ứng với UNSIGNED SMALLINT tự động tăng làm khóa chính:

$table->smallIncrements('id');

smallInteger()

Phương thức smallInteger sẽ tạo một cột tương ứng với SMALLINT:

$table->smallInteger('votes');

softDeletesTz()

Phương thức softDeletesTz sẽ thêm một cột tương ứng với deleted_at TIMESTAMP (cùng timezone) và có thể nullable cùng độ chính xác giây tính đến hàng phân số phía sau dấu chấm. Cột này nhằm mục đích để lưu trữ timestamp deleted_at sẽ cần thiết cho chức năng "soft delete" của Eloquent:

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

softDeletes()

Phương thức softDeletes sẽ thêm một cột tương ứng với deleted_at TIMESTAMP và có thể nullable cùng độ chính xác giây tính đến hàng phân số phía sau dấu chấm. Cột này nhằm mục đích để lưu trữ timestamp deleted_at sẽ cần thiết cho chức năng "soft delete" của Eloquent:

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

string()

Phương thức string sẽ tạo một cột tương ứng với VARCHAR và độ dài cho trước:

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

text()

Phương thức text sẽ tạo một cột tương ứng với TEXT:

$table->text('description');

Khi sử dụng MySQL hoặc MariaDB, bạn có thể áp dụng bộ ký tự binary cho cột để tạo ra một cột tương đương BLOB:

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

timeTz()

Phương thức timeTz sẽ tạo cột tương ứng với TIME (cùng timezone) với độ chính xác giây tính đến hàng phân số phía sau dấu chấm:

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

time()

Phương thức time sẽ tạo cột tương ứng với TIME với độ chính xác giây tính đến hàng phân số phía sau dấu chấm:

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

timestampTz()

Phương thức timestampTz sẽ tạo cột tương ứng với TIMESTAMP (cùng timezone) với độ chính xác giây tính đến hàng phân số phía sau dấu chấm:

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

timestamp()

Phương thức timestamp sẽ tạo cột tương ứng với TIMESTAMP với độ chính xác giây tính đến hàng phân số phía sau dấu chấm:

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

timestampsTz()

Phương thức timestampsTz sẽ tạo các cột created_at và updated_at TIMESTAMP (cùng timezone) với độ chính xác giây tính đến hàng phân số phía sau dấu chấm:

$table->timestampsTz(precision: 0);

timestamps()

Phương thức timestamps sẽ tạo các cột created_at và updated_at TIMESTAMP với độ chính xác giây tính đến hàng phân số phía sau dấu chấm:

$table->timestamps(precision: 0);

tinyIncrements()

Phương thức tinyIncrements sẽ tạo một cột tương ứng với UNSIGNED TINYINT tự động tăng làm khóa chính:

$table->tinyIncrements('id');

tinyInteger()

Phương thức tinyInteger sẽ tạo một cột tương ứng với TINYINT:

$table->tinyInteger('votes');

tinyText()

Phương thức tinyText sẽ tạo một cột tương ứng với TINYTEXT:

$table->tinyText('notes');

Khi sử dụng MySQL hoặc MariaDB, bạn có thể áp dụng bộ ký tự binary cho cột để tạo ra một cột tương đương TINYBLOB:

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

unsignedBigInteger()

Phương thức unsignedBigInteger sẽ tạo một cột tương ứng với UNSIGNED BIGINT:

$table->unsignedBigInteger('votes');

unsignedInteger()

Phương thức unsignedInteger sẽ tạo một cột tương ứng với UNSIGNED INTEGER:

$table->unsignedInteger('votes');

unsignedMediumInteger()

Phương thức unsignedMediumInteger sẽ tạo một cột tương ứng với UNSIGNED MEDIUMINT:

$table->unsignedMediumInteger('votes');

unsignedSmallInteger()

Phương thức unsignedSmallInteger sẽ tạo một cột tương ứng với UNSIGNED SMALLINT:

$table->unsignedSmallInteger('votes');

unsignedTinyInteger()

Phương thức unsignedTinyInteger sẽ tạo một cột tương ứng với UNSIGNED TINYINT:

$table->unsignedTinyInteger('votes');

ulidMorphs()

Phương thức ulidMorphs là một phương thức rất tiện lợi, nó sẽ thêm một cột tương ứng với {column}_id CHAR(26) và một cột khác là {column}_type VARCHAR.

Mục đích phương thức này là nhằm sử dụng khi định nghĩa các cột cần thiết cho quan hệ đa hình. Trong ví dụ dưới, các cột taggable_id và taggable_type sẽ được tạo:

$table->ulidMorphs('taggable');

uuidMorphs()

Phương thức uuidMorphs là một phương thức rất tiện lợi, nó sẽ thêm một cột tương ứng với {column}_id CHAR(36) và một cột khác là {column}_type VARCHAR.

Mục đích phương thức này là nhằm sử dụng khi định nghĩa các cột cần thiết cho quan hệ đa hình. Trong ví dụ dưới, các cột taggable_id và taggable_type sẽ được tạo:

$table->uuidMorphs('taggable');

ulid()

Phương thức ulid sẽ tạo một cột tương ứng với ULID:

$table->ulid('id');

uuid()

Phương thức uuid sẽ tạo một cột tương ứng với UUID:

$table->uuid('id');

vector()

Phương thức vector sẽ tạo một cột tương ứng với vector:

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

Khi sử dụng PostgreSQL, extension pgvector phải được load trước khi các cột vector được tạo:

Schema::ensureVectorExtensionExists();

year()

Phương thức year sẽ tạo một cột tương ứng với YEAR:

$table->year('birth_year');

Column Modifiers

Ngoài các loại cột được liệt kê ở trên, có một số "modifiers" cột mà bạn có thể sử dụng khi thêm một cột vào trong bảng cơ sở dữ liệu. Ví dụ, để tạo một cột chấp nhận "nullable", bạn có thể sử dụng phương thức nullable:

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

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

Bảng dưới đây sẽ chứa tất cả các column modifier có sẵn. Danh sách này không bao gồm index modifiers:

div class="overflow-auto">