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 dễ dàng sửa và chia sẻ các database schema của application. Migration thường được kết hợp với schema builder của Laravel để xây dựng database schema cho application của bạn. 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ọ, thì bạn đã từng phải 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.

Tạo Migration

Để tạo một migration, hãy sử dụng Lệnh Artisan make:migration:

php artisan make:migration create_users_table

File migration mới sẽ được lưu trong thư mục database/migrations của bạn. Mỗi tên file migration đều có chứa một dấu mốc timestamp cho phép Laravel xác định thứ tự migration.

Các tùy chọn --table và --create cũng có thể được sử dụng để chỉ định tên bảng và migration có tạo một bảng mới hay không. Những tùy chọn này sẽ được điền trước vào file migration sẽ được tạo cùng với tên bảng đã được chỉ định:

php artisan make:migration create_users_table --create=users

php artisan make:migration add_votes_to_users_table --table=users

Nếu bạn muốn khai báo một đường dẫn output tùy biến cho file migration được tạo, bạn có thể sử dụng tùy chọn --path khi chạy lệnh make:migration. Đường dẫn tuỳ biến này phải được bắt đầu từ đường dẫn root của application của bạn.

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 mẫu này sẽ tạo ra một bảng flights:

<?php

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

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

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

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

{note} Nếu bạn đang sử dụng máy ảo Homestead, bạn nên chạy lệnh này từ bên trong máy ảo của bạn.

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

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

Rollback & Migrate In 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 & 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

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:

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

Tất nhiên, 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.

Checking For Table / Column Existence

Bạn có thể dễ dàng kiểm tra sự tồn tại của một bảng hoặc một cột bằng các phương thức hasTable và hasColumn:

if (Schema::hasTable('users')) {
    //
}

if (Schema::hasColumn('users', 'email')) {
    //
}

Database Connection & 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 bạn, hãy sử dụng phương thức connection:

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

Bạn có thể sử dụng các lệnh sau trên schema builder để định nghĩa các tùy chọn cho bảng:

Đổ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: 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 Blueprint mà bạn có thể sử dụng nó để thêm các cột vào trong bảng:

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

Available Column Types

Tất nhiên, schema builder cũng sẽ chứa nhiều loại cột mà bạn có thể khai báo khi xây dựng các bảng cho bạn:

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 trong 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:

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

Dưới đây là danh sách tất cả các column modifier có sẵn. Danh sách này không bao gồm index modifiers:

Sửa Column

Prerequisites

Trước khi sửa một cột, bạn hãy chắc chắn là bạn đã thêm library doctrine/dbal vào trong file composer.json của bạn. Thư viện Doctrine DBAL được sử dụng để xác định trạng thái hiện tại của cột và tạo ra các truy vấn SQL cần thiết để thực hiện các khai báo điều chỉnh cho các cột đó:

composer require doctrine/dbal

Updating Column Attributes

Phương thức change cho phép bạn sửa một số loại cột hiện có thành một loại mới hoặc sửa các thuộc tính của cột. Ví dụ: bạn có thể muốn tăng kích thước của cột string. Để xem phương thức change hoạt động như thế nào, hãy thử tăng kích thước của cột name từ 25 lên 50:

Schema::table('users', function (Blueprint $table) {
    $table->string('name', 50)->change();
});

Chúng ta cũng có thể sửa một cột thành nullable:

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

{note} Chỉ có thể "thay đổi" các loại cột sau: bigInteger, binary, boolean, date, dateTime, dateTimeTz, decimal, integer, json, longText, mediumText, smallInteger, string, text, time, unsignedBigInteger, unsignedInteger và unsignedSmallInteger.

Renaming Columns

Để đổi tên một cột, bạn có thể sử dụng phương thức renameColumn trong Schema builder. Trước khi đổi tên một cột, hãy nhớ thêm library doctrine/dbal vào trong file composer.json của bạn:

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

{note} Việc đổi tên cột trong một bảng mà có chứa một cột khác kiểu enum thì sẽ không thể đổi được.

Xoá Column

Để xóa một cột, hãy sử dụng phương thức dropColumn trong Schema builder. Trước khi xóa một cột ra khỏi cơ sở dữ liệu SQLite, bạn sẽ cần thêm library doctrine/dbal vào trong file composer.json của bạn và chạy lệnh composer update trong terminal để cài đặt thư viện:

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

Bạn có thể xóa nhiều cột từ một bảng bằng cách truyền một mảng gồm tên các cột vào trong phương thức dropColumn:

Schema::table('users', function (Blueprint $table) {
    $table->dropColumn(['votes', 'avatar', 'location']);
});

{note} Nếu bạn đang sử dụng cơ sở dữ liệu SQLite thì việc xóa hoặc sửa nhiều cột trong một file migration sẽ không được hỗ trợ.

Available Command Aliases

Index

Tạo Index

Schema builder có hỗ trợ một số loại cindex. Trước tiên, hãy xem một ví dụ khai báo giá trị của một cột phải là unique. Để tạo một index, chúng ta có thể kết hợp thêm phương thức unique vào trong định nghĩa của cột:

$table->string('email')->unique();

Ngoài ra, bạn có thể tạo index sau khi định nghĩa cột. Ví dụ:

$table->unique('email');

Bạn thậm chí có thể truyền một mảng gồm các cột cho một phương thức index để tạo index gộp (hoặc index hỗn hợp):

$table->index(['account_id', 'created_at']);

Laravel sẽ tự động tạo một tên index phù hợp, nhưng bạn có thể truyền thêm tham số thứ hai cho phương thức để khai báo tên đó:

$table->unique('email', 'unique_email');

Available Index Types

Mỗi phương thức của index chấp nhận một đối số thứ hai tùy chọn để chỉ định tên của index. Nếu bỏ qua tuỳ chọn này, thì tên sẽ được lấy từ tên của (các) bảng và cột.

Index Lengths & MySQL / MariaDB

Laravel sử dụng ký tự mặc định là utf8mb4, hỗ trợ lưu trữ cả "biểu tượng cảm xúc" trong cơ sở dữ liệu. Nếu bạn đang chạy phiên bản MySQL cũ hơn phiên bản 5.7.7 hoặc MariaDB cũ hơn phiên bản 10.2.2, bạn có thể cần phải tự cấu hình độ dài mặc định của chuỗi được tạo bởi migration, để MySQL tạo index cho chúng. Bạn có thể cấu hình điều này bằng cách gọi phương thức Schema::defaultStringLength trong AppServiceProvider của bạn:

use Illuminate\Support\Facades\Schema;

/**
 * Bootstrap any application services.
 *
 * @return void
 */
public function boot()
{
    Schema::defaultStringLength(191);
}

Ngoài ra, bạn có thể kích hoạt tùy chọn innodb_large_prefix cho cơ sở dữ liệu của bạn. Tham khảo tài liệu của cơ sở dữ liệu của bạn để biết thêm hướng dẫn về cách bật tùy chọn này.

Đổi tên Index

Để đổi tên một index, bạn có thể sử dụng phương thức renameIndex. Phương thức này chấp nhận tên index hiện tại làm đối số đầu tiên và tên mong muốn làm đối số thứ hai:

$table->renameIndex('from', 'to')

Xoá Index

Để xóa một index, bạn có thể khai báo một tên index. Mặc định, Laravel sẽ tự động gán một tên phù hợp cho các index. Chỉ cần nối tên bảng và tên cột index và loại index. Dưới đây là một số ví dụ:

Nếu bạn truyền một mảng gồm các cột vào trong một phương thức xoá index, thì quy ước tên index sẽ được tạo dựa trên tên bảng, tên cột và loại khóa:

Schema::table('geo', function (Blueprint $table) {
    $table->dropIndex(['state']); // Drops index 'geo_state_index'
});

Rằng buộc khoá ngoại

Laravel cũng cung cấp hỗ trợ để tạo các ràng buộc khóa ngoại, được sử dụng để đảm bảo tính toàn vẹn cho cơ sở dữ liệu. Ví dụ: hãy định nghĩa một cột user_id trong bảng posts là khoá ngoại của cột id trong bảngusers:

Schema::table('posts', function (Blueprint $table) {
    $table->unsignedInteger('user_id');

    $table->foreign('user_id')->references('id')->on('users');
});

Bạn cũng có thể khai báo hành động mong muốn cho các thuộc tính của ràng buộc "khi xóa" hoặc "khi cập nhật":

$table->foreign('user_id')
      ->references('id')->on('users')
      ->onDelete('cascade');

Để xoá khóa ngoại, bạn có thể sử dụng phương thức dropForeign. Các ràng buộc khóa ngoại sẽ được sử dụng theo quy ước đặt tên giống với các index. Vì vậy, chúng ta sẽ nối tên bảng và tên cột trong ràng buộc, sau đó thêm hậu tố "_foreign":

$table->dropForeign('posts_user_id_foreign');

Hoặc, bạn có thể truyền một mảng các giá trị sẽ tự động sử dụng quy ước tên ràng buộc khi xoá:

$table->dropForeign(['user_id']);

Bạn có thể bật hoặc tắt các ràng buộc khóa ngoại trong migration của bạn bằng cách sử dụng các phương thức sau:

Schema::enableForeignKeyConstraints();

Schema::disableForeignKeyConstraints();