Hướng dẫn Migration_Database - Lavarel

Chào các bạn, những kiến trúc sư phần mềm tương lai! Hôm nay chúng ta sẽ cùng nhau "đào bới" một khái niệm mà tôi dám cá là bạn sẽ gặp đi gặp lại hàng ngày nếu dấn thân vào con đường phát triển ứng dụng web hiện đại, đặc biệt là với Laravel. Đó chính là Database Migration – hay nôm na là "Di trú Cơ sở dữ liệu".

Hãy tưởng tượng thế này: Bạn đang xây một ngôi nhà, và cơ sở dữ liệu (database) chính là cái "móng" và "khung xương" của ngôi nhà đó. Ban đầu, bạn có một bản thiết kế (schema) đơn giản: vài phòng, một cái bếp. Nhưng rồi, khách hàng muốn thêm một tầng lầu, một ban công, hay thậm chí là thay đổi kích thước phòng khách. Bạn sẽ làm gì? Chắc chắn không phải là cứ thế đập phá lung tung mà không có một kế hoạch rõ ràng, đúng không? Bạn cần một kiến trúc sư vẽ lại bản thiết kế, xin giấy phép xây dựng, và sau đó mới tiến hành thi công một cách bài bản.

Database Migration trong Laravel chính là "kiến trúc sư", "bản thiết kế sửa đổi" và "giấy phép xây dựng" đó cho cơ sở dữ liệu của bạn.

1. Database Migration là gì và để làm gì?

Database Migration là một phương pháp quản lý, theo dõi và phiên bản hóa (version control) các thay đổi cấu trúc (schema) của cơ sở dữ liệu. Thay vì bạn phải tự tay gõ từng câu lệnh SQL ALTER TABLE hay CREATE TABLE mỗi khi muốn thêm cột, sửa kiểu dữ liệu, hay tạo bảng mới, bạn sẽ viết các "file migration" bằng PHP. Những file này mô tả các thay đổi bạn muốn thực hiện, và Laravel sẽ lo phần còn lại: chuyển đổi các mô tả PHP đó thành các lệnh SQL phù hợp với hệ quản trị cơ sở dữ liệu bạn đang dùng (MySQL, PostgreSQL, SQLite...).

Vậy, tại sao chúng ta lại cần đến "kiến trúc sư" này?

• Đồng bộ hóa "bản vẽ" giữa các đồng đội: Khi làm việc nhóm, mỗi người có thể thêm tính năng mới, đồng nghĩa với việc database cũng cần thay đổi. Migration đảm bảo mọi người đều có cùng một cấu trúc database, tránh xa cái kiểu "nó chạy trên máy tôi mà!" vì ông A thêm cột mà ông B không biết.
• Triển khai (Deployment) thần tốc và an toàn: Khi đưa ứng dụng lên môi trường thử nghiệm (staging) hay môi trường thực tế (production), bạn không cần phải nhớ "à hôm trước mình thêm cái cột X vào bảng Y". Chỉ cần chạy một lệnh, Laravel sẽ tự động cập nhật database lên phiên bản mới nhất.
• Khả năng "undo" (hoàn tác) tuyệt vời: Lỡ tay thêm một cột sai kiểu dữ liệu? Hay tạo nhầm bảng? Migration cho phép bạn dễ dàng "quay ngược thời gian" (rollback) để hoàn tác các thay đổi gần nhất, hoặc thậm chí là "reset" toàn bộ database về trạng thái ban đầu.
• Lịch sử thay đổi rõ ràng: Mỗi file migration là một "ghi chép" về một thay đổi cụ thể. Bạn có thể nhìn vào thư mục database/migrations để biết database của mình đã "tiến hóa" như thế nào qua thời gian.
• Độc lập với loại Database: Bạn viết migration bằng PHP, Laravel sẽ tự động dịch sang SQL phù hợp với MySQL, PostgreSQL hay SQLite. Điều này giúp ứng dụng của bạn linh hoạt hơn khi cần chuyển đổi giữa các hệ quản trị CSDL.

Nói tóm lại, Migration là công cụ không thể thiếu để quản lý cấu trúc database của ứng dụng một cách chuyên nghiệp, có tổ chức, và dễ dàng cộng tác. Nó biến việc thay đổi database từ một công việc tiềm ẩn rủi ro thành một quy trình có kiểm soát.

2. Code Ví Dụ Minh Hoạ Rõ Ràng với Laravel

Laravel cung cấp một hệ thống migration mạnh mẽ thông qua Artisan CLI.

Bước 1: Tạo một Migration mới

Để tạo một file migration, bạn dùng lệnh Artisan:

php artisan make:migration create_products_table

Lệnh này sẽ tạo ra một file PHP trong thư mục database/migrations với tên dạng YYYY_MM_DD_HHMMSS_create_products_table.php. Tên file rất quan trọng vì nó chứa dấu thời gian, đảm bảo các migration được chạy theo đúng thứ tự.

Nội dung cơ bản của file migration sẽ trông như thế này:

<?php

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

return new class extends Migration
{
    /**
     * Run the migrations.
     *
     * @return void
     */
    public function up()
    {
        Schema::create('products', function (Blueprint $table) {
            $table->id(); // Khóa chính tự tăng
            // Các cột khác sẽ được thêm vào đây
            $table->timestamps(); // Cột created_at và updated_at
        });
    }

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

• up() method: Chứa logic để thực hiện các thay đổi vào database (ví dụ: tạo bảng, thêm cột). Đây là phương thức được gọi khi bạn chạy migration.
• down() method: Chứa logic để hoàn tác các thay đổi đã thực hiện trong up() (ví dụ: xóa bảng, xóa cột). Đây là phương thức được gọi khi bạn rollback migration.

Bước 2: Ví dụ về các thao tác phổ biến

Ví dụ 1: Tạo một bảng mới (create_products_table)

Tiếp tục với file create_products_table.php ở trên, chúng ta sẽ thêm các cột cho bảng products:

Gợi Ý Đọc Tiếp

Hướng dẫn Artisan_Console - Lavarel

6 Lượt xem

<?php

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

return new class extends Migration
{
    /**
     * Run the migrations.
     *
     * @return void
     */
    public function up()
    {
        Schema::create('products', function (Blueprint $table) {
            $table->id(); // Khóa chính tự tăng, kiểu UNSIGNED BIGINT
            $table->string('name', 255)->unique(); // Tên sản phẩm, chuỗi, tối đa 255 ký tự, duy nhất
            $table->text('description')->nullable(); // Mô tả sản phẩm, văn bản dài, có thể NULL
            $table->decimal('price', 8, 2)->default(0.00); // Giá sản phẩm, số thập phân (8 chữ số tổng, 2 chữ số sau dấu phẩy), mặc định 0.00
            $table->unsignedInteger('stock')->default(0); // Số lượng tồn kho, số nguyên không dấu, mặc định 0
            $table->boolean('is_active')->default(true); // Trạng thái hoạt động, boolean, mặc định TRUE
            $table->timestamps(); // Tự động thêm created_at và updated_at
        });
    }

    /**
     * Reverse the migrations.
     *
     * @return void
     */
    public function down()
    {
        Schema::dropIfExists('products'); // Xóa bảng 'products' nếu tồn tại
    }
};

Ví dụ 2: Thêm một cột mới vào bảng đã có (add_category_id_to_products_table)

php artisan make:migration add_category_id_to_products_table --table=products

File migration sẽ có nội dung:

<?php

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

return new class extends Migration
{
    /**
     * Run the migrations.
     *
     * @return void
     */
    public function up()
    {
        Schema::table('products', function (Blueprint $table) {
            // Thêm cột category_id sau cột name
            $table->foreignId('category_id')
                  ->nullable() // Có thể null
                  ->after('name') // Vị trí của cột (tùy chọn)
                  ->constrained('categories') // Tạo khóa ngoại liên kết với bảng 'categories'
                  ->onDelete('set null'); // Khi category bị xóa, category_id trong products sẽ thành NULL
        });
    }

    /**
     * Reverse the migrations.
     *
     * @return void
     */
    public function down()
    {
        Schema::table('products', function (Blueprint $table) {
            $table->dropForeign(['category_id']); // Xóa khóa ngoại trước
            $table->dropColumn('category_id'); // Sau đó xóa cột
        });
    }
};

Ví dụ 3: Thay đổi kiểu dữ liệu hoặc thuộc tính của một cột (change_description_column_in_products_table)

Để thay đổi cột, bạn cần cài đặt thư viện doctrine/dbal:

composer require doctrine/dbal

Sau đó, tạo migration:

php artisan make:migration change_description_column_in_products_table --table=products

File migration:

<?php

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

return new class extends Migration
{
    /**
     * Run the migrations.
     *
     * @return void
     */
    public function up()
    {
        Schema::table('products', function (Blueprint $table) {
            // Thay đổi cột 'description' từ TEXT thành STRING với giới hạn 500 ký tự và vẫn có thể NULL
            $table->string('description', 500)->nullable()->change();
        });
    }

    /**
     * Reverse the migrations.
     *
     * @return void
     */
    public function down()
    {
        Schema::table('products', function (Blueprint $table) {
            // Hoàn tác: Thay đổi lại thành TEXT và có thể NULL
            $table->text('description')->nullable()->change();
        });
    }
};

Ví dụ 4: Xóa một cột (remove_is_active_from_products_table)

php artisan make:migration remove_is_active_from_products_table --table=products

File migration:

<?php

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

return new class extends Migration
{
    /**
     * Run the migrations.
     *
     * @return void
     */
    public function up()
    {
        Schema::table('products', function (Blueprint $table) {
            $table->dropColumn('is_active');
        });
    }

    /**
     * Reverse the migrations.
     *
     * @return void
     */
    public function down()
    {
        Schema::table('products', function (Blueprint $table) {
            // Khi rollback, thêm lại cột is_active với các thuộc tính ban đầu
            $table->boolean('is_active')->default(true)->after('stock');
        });
    }
};

Bước 3: Chạy các Migration

Sau khi đã viết xong các file migration, bạn cần chạy chúng để áp dụng các thay đổi vào database:

php artisan migrate

Lệnh này sẽ chạy tất cả các migration chưa được chạy. Laravel sẽ tạo một bảng migrations trong database của bạn để theo dõi những migration nào đã được thực hiện.

Bước 4: Hoàn tác các Migration

• Hoàn tác migration gần nhất:

  php artisan migrate:rollback
  

• Hoàn tác tất cả các migration:

  php artisan migrate:reset
  

• Hoàn tác tất cả migration và sau đó chạy lại: Thường dùng khi phát triển để "làm mới" database.

  php artisan migrate:refresh
  

  Nếu bạn muốn chạy kèm theo Seeder (để điền dữ liệu mẫu), dùng:

  php artisan migrate:refresh --seed
  

• Xóa toàn bộ database, chạy lại migration và seed: Tuyệt vời cho môi trường phát triển cục bộ.

  php artisan migrate:fresh --seed
  

3. Mẹo (Best Practices) để ghi nhớ hoặc dùng thực tế

1. Tên Migration phải "kể chuyện": Hãy đặt tên thật rõ ràng, mô tả đúng hành động mà migration thực hiện (ví dụ: create_users_table, add_email_to_users_table, rename_product_price_column). Tên càng tường minh, càng dễ theo dõi lịch sử thay đổi.
2. Mỗi Migration, một nhiệm vụ: Tránh nhồi nhét quá nhiều thay đổi vào một file migration. Nếu bạn tạo bảng mới và thêm vài cột vào bảng khác, hãy tách ra thành hai migration riêng biệt. Điều này giúp down() method dễ viết hơn và việc rollback cũng chính xác hơn.
3. Luôn luôn viết down() method cẩn thận: Phương thức down() là "công tắc khẩn cấp" để quay lại. Đảm bảo nó hoàn tác chính xác những gì up() đã làm. Nếu up() tạo bảng, down() phải xóa bảng đó (Schema::dropIfExists). Nếu up() thêm cột, down() phải xóa cột đó ($table->dropColumn).
4. Cẩn trọng với change() và drop(): Thay đổi hoặc xóa cột có thể gây mất dữ liệu. Luôn kiểm tra kỹ lưỡng, đặc biệt là trên môi trường phát triển trước khi đẩy lên production. Và nhớ, để dùng change() bạn phải cài doctrine/dbal.
5. Không sửa migration cũ đã chạy trên production: Nếu một migration đã được triển khai và chạy trên môi trường production, tuyệt đối không chỉnh sửa file migration đó. Nếu bạn cần thay đổi thêm, hãy tạo một migration mới. Sửa migration cũ có thể gây ra sự không đồng bộ giữa database của bạn và database trên server.
6. Sử dụng đầy đủ các kiểu dữ liệu của Blueprint: Laravel cung cấp rất nhiều helper để định nghĩa cột ($table->string(), $table->integer(), $table->boolean(), $table->timestamp(), $table->foreignId()). Hãy tận dụng chúng để code của bạn rõ ràng và nhất quán.
7. Migration không phải Seeder: Migration lo việc xây dựng cấu trúc nhà (schema). Seeder lo việc điền nội thất, dữ liệu ban đầu vào nhà. Đừng nhầm lẫn hai vai trò này.
8. Sử dụng ->nullable() một cách có ý thức: Một cột nullable() cho phép nó không có giá trị. Nếu dữ liệu đó luôn phải có, đừng để nullable().

4. Ví dụ thực tế các ứng dụng/website đã ứng dụng

Hầu hết các framework phát triển web hiện đại, đặc biệt là những framework sử dụng ORM (Object-Relational Mapping), đều có hệ thống migration tương tự Laravel. Đây không phải là một tính năng độc quyền mà là một tiêu chuẩn vàng trong phát triển ứng dụng:

• Laravel (PHP): Như chúng ta vừa tìm hiểu, Laravel với Eloquent ORM và Artisan CLI là một ví dụ điển hình. Mọi ứng dụng được xây dựng trên Laravel, từ các website tin tức đơn giản đến các hệ thống thương mại điện tử phức tạp, đều sử dụng migration để quản lý database.
• Ruby on Rails (Ruby): Framework này là một trong những người tiên phong phổ biến hóa khái niệm migration với ActiveRecord. Các ứng dụng như GitHub, Shopify, Airbnb đều được xây dựng trên Rails và sử dụng migration triệt để.
• Django (Python): Tương tự, Django cũng có hệ thống migration mạnh mẽ cho ORM của nó. Instagram, Spotify, Dropbox là những ví dụ về ứng dụng dùng Django.
• NestJS (Node.js): Với TypeORM hoặc Sequelize, các ứng dụng back-end phát triển bằng NestJS cũng tích hợp chặt chẽ việc quản lý schema qua migration.
• Các CMS lớn như WordPress, Drupal, Magento: Mặc dù có thể không gọi trực tiếp là "migration" theo kiểu Laravel, nhưng các hệ thống này đều có cơ chế riêng để cập nhật cấu trúc database khi bạn nâng cấp phiên bản hoặc cài đặt/gỡ bỏ plugin/module. Chúng đều giải quyết bài toán cốt lõi là giữ cho database schema nhất quán và có thể nâng cấp được.

Tóm lại, bất kỳ ứng dụng nào cần "sống sót" qua nhiều lần thay đổi tính năng, nhiều lần triển khai, và được phát triển bởi một nhóm lập trình viên, đều cần một hệ thống quản lý schema có phiên bản. Database Migration chính là câu trả lời cho nhu cầu đó. Nó là một "vật bất ly thân" của người làm web hiện đại.

Hy vọng với bài giảng này, bạn đã có một cái nhìn toàn diện và sẵn sàng "cầm búa, cầm kìm" để xây dựng và bảo trì những "ngôi nhà" database vững chắc cho các ứng dụng của mình!