Laravel Migration : Tutorial Lengkap untuk Pemula

Apakah Anda pernah merasa frustrasi ketika harus menyelaraskan skema database di lingkungan tim? Bayangkan jika setiap anggota tim Anda harus mengubah tabel secara manual setiap kali Anda menambahkan kolom baru sebuah resep sempurna untuk bencana. Di sinilah Migration di Laravel 12 hadir sebagai pahlawan tanpa tanda jasa.

Topik ini sangat krusial bagi siapa saja yang ingin membangun aplikasi yang scalable dan mudah dipertahankan. Jika Anda ingin sepenuhnya memahami migration laravel 12 dan bagaimana menggunakannya untuk mengelola skema database seperti seorang master, Anda berada di tempat yang tepat.

Apa Itu Laravel Migration dan Mengapa Penting

Migration, secara sederhana, adalah seperti “Version Control System” (VCS) untuk database Anda. Sama seperti Git melacak perubahan pada kode sumber Anda, Migration di Laravel melacak perubahan struktural pada database Anda, mulai dari pembuatan tabel, penambahan kolom, hingga penghapusan indeks.

Ini adalah inti dari database schema definition yang dapat dibagikan dan dieksekusi ulang oleh seluruh tim Anda.

Filosofi ‘Version Control’ untuk Database Anda

Dalam lingkungan pengembangan modern, konsistensi adalah kunci. Tanpa Migration, setiap developer di tim Anda akan memiliki database lokal yang berbeda. Ketika satu developer menambahkan kolom is_verified ke tabel users, developer lain harus diberitahu untuk menjalankannya secara manual.

Dengan Migration, seluruh prosesnya otomatis. Setiap perubahan pada skema didefinisikan dalam file PHP yang berpasangan. Ketika tim Anda menarik kode terbaru, mereka hanya perlu menjalankan satu perintah: php artisan migrate. Semudah itu! Konsistensi terjamin, dan setup lingkungan baru menjadi hitungan detik.

Laravel Migration vs Mengubah Database Secara Manual (Pain Point)

Ini adalah pain point terbesar yang diselesaikan oleh fitur ini. Dengan Laravel 12, arsitektur Migration sudah matang dan menawarkan alat-alat yang database agnostic, artinya kode yang Anda tulis akan bekerja di MySQL, PostgreSQL, SQLite, atau bahkan SQL Server.

Membuat Laravel Migration

Langkah pertama dalam menggunakan Migration adalah membuatnya. Proses ini sangat disederhanakan berkat Artisan Console, alat baris perintah (CLI) bawaan Laravel.

Perintah Artisan

Untuk memulai membuat migration laravel, Anda cukup menggunakan perintah berikut. Laravel akan menebak apakah Anda ingin membuat tabel baru atau memodifikasi yang sudah ada.

# Untuk membuat tabel baru (ditebak oleh Laravel)
php artisan make:migration create_products_table

# Untuk memodifikasi tabel yang sudah ada (gunakan flag --table)
php artisan make:migration add_stock_to_products_table --table=products 

# Untuk membuat tabel baru (ditebak oleh Laravel)
php artisan make:migration create_products_table

# Untuk memodifikasi tabel yang sudah ada (gunakan flag --table)
php artisan make:migration add_stock_to_products_table --table=products 

File yang baru dibuat akan ditempatkan di direktori database/migrations dan memiliki timestamp unik (misalnya, 2025_10_27_000000_create_products_table.php). Timestamp ini penting karena Laravel menggunakannya untuk menentukan urutan eksekusi migration.

Konvensi Nama File dan Struktur Dasar Laravel Migration

Setiap kelas migration memiliki struktur dasar yang berisi dua metode penting: up() dan down().

1. up(): Metode ini digunakan untuk menjalankan perubahan, seperti membuat tabel, menambah kolom, atau menambah indeks. Inilah yang terjadi ketika Anda menjalankan php artisan migrate.
2. down(): Metode ini digunakan untuk memutar balik perubahan yang dilakukan di up(). Metode ini harus membalikkan secara persis apa yang dilakukan oleh up(). Ini adalah fitur penting untuk rollback.

Migration Dasar

Mari kita lihat contoh lengkap file migration untuk membuat tabel products:

<?php

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

return new class extends Migration
{
    /**
     * Run the migrations (Perubahan yang akan Diterapkan).
     */
    public function up(): void
    {
        Schema::create('products', function (Blueprint $table) {
            $table->id(); // Kolom ID auto-increment
            $table->string('name', 150); // Nama produk
            $table->text('description')->nullable(); // Deskripsi (opsional)
            $table->decimal('price', 10, 2); // Harga produk
            $table->unsignedInteger('stock')->default(0); // Stok
            $table->timestamps(); // Kolom created_at dan updated_at
        });
    }

    /**
     * Reverse the migrations (Memutar balik perubahan di atas).
     */
    public function down(): void
    {
        // Cukup hapus tabelnya
        Schema::dropIfExists('products');
    }
};

<?php

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

return new class extends Migration
{
    /**
     * Run the migrations (Perubahan yang akan Diterapkan).
     */
    public function up(): void
    {
        Schema::create('products', function (Blueprint $table) {
            $table->id(); // Kolom ID auto-increment
            $table->string('name', 150); // Nama produk
            $table->text('description')->nullable(); // Deskripsi (opsional)
            $table->decimal('price', 10, 2); // Harga produk
            $table->unsignedInteger('stock')->default(0); // Stok
            $table->timestamps(); // Kolom created_at dan updated_at
        });
    }

    /**
     * Reverse the migrations (Memutar balik perubahan di atas).
     */
    public function down(): void
    {
        // Cukup hapus tabelnya
        Schema::dropIfExists('products');
    }
};

Tips: Selalu pastikan metode down() Anda dapat memutar balik up() dengan aman. Menggunakan Schema::dropIfExists() adalah praktik yang baik.

Menggunakan Migration untuk Modifikasi Skema

Inti kekuatan Migration terletak pada objek Blueprint yang Anda terima di dalam closure up() dan down(). Objek ini memberi Anda akses ke Schema Builder yang memungkinkan Anda memanipulasi skema database.

Menciptakan dan Mendefinisikan Kolom (Schema::create)

Ketika Anda menggunakan migration di laravel untuk membuat tabel, Anda menggunakan berbagai metode pada objek $table (instance dari Blueprint) untuk menentukan kolom.

Tipe Data Populer yang Wajib Dikuasai

Laravel Schema Builder menyediakan banyak metode yang menerjemahkan ke tipe data spesifik di database Anda:

• $table->id(): Alias untuk bigIncrements(‘id’). Wajib untuk Primary Key.
• $table->string(‘kolom’): Setara dengan VARCHAR. Anda bisa menentukan panjangnya (misal: string(‘name’, 100)).
• $table->text(‘kolom’): Untuk teks yang lebih panjang.
• $table->boolean(‘kolom’): Untuk nilai TRUE atau FALSE.
• $table->integer(‘kolom’) / unsignedBigInteger(‘kolom’): Untuk bilangan bulat.
• $table->timestamps(): Otomatis menambahkan kolom created_at dan updated_at.
• $table->softDeletes(): Menambahkan kolom deleted_at untuk soft delete (penghapusan lunak).

Edit Tabel dengan Migration Laravel 12

Seringkali, Anda perlu edit tabel dengan migration laravel yang sudah ada, misalnya menambahkan kolom baru atau mengganti tipe kolom. Untuk kasus ini, kita menggunakan Schema::table().

// 2025_11_03_000000_add_discount_to_products_table.php

public function up(): void
{
    Schema::table('products', function (Blueprint $table) {
        // Menambahkan kolom baru setelah kolom 'price'
        $table->decimal('discount', 4, 2)->default(0.00)->after('price');

        // Menambahkan indeks untuk pencarian cepat
        $table->index('stock'); 
    });
}

public function down(): void
{
    Schema::table('products', function (Blueprint $table) {
        // Balikkan perubahan: hapus kolom dan indeks
        $table->dropColumn('discount');
        $table->dropIndex(['stock']);
    });
}

// 2025_11_03_000000_add_discount_to_products_table.php

public function up(): void
{
    Schema::table('products', function (Blueprint $table) {
        // Menambahkan kolom baru setelah kolom 'price'
        $table->decimal('discount', 4, 2)->default(0.00)->after('price');

        // Menambahkan indeks untuk pencarian cepat
        $table->index('stock'); 
    });
}

public function down(): void
{
    Schema::table('products', function (Blueprint $table) {
        // Balikkan perubahan: hapus kolom dan indeks
        $table->dropColumn('discount');
        $table->dropIndex(['stock']);
    });
}

Mengubah dan Menghapus Kolom (Rename, Drop)

Untuk mengubah tipe atau atribut kolom yang sudah ada, Anda perlu menginstal package doctrine/dbal terlebih dahulu. Setelah itu, Anda bisa menggunakan metode change():

// Mengubah tipe kolom 'description' dari TEXT menjadi LONGTEXT
$table->text('description')->change(); 

// Mengganti nama kolom
Schema::table('products', function (Blueprint $table) {
    $table->renameColumn('old_name', 'new_name');
});

// Mengubah tipe kolom 'description' dari TEXT menjadi LONGTEXT
$table->text('description')->change(); 

// Mengganti nama kolom
Schema::table('products', function (Blueprint $table) {
    $table->renameColumn('old_name', 'new_name');
});

Perhatian Khusus: Sebelum mengganti nama tabel, pastikan Anda telah menetapkan nama eksplisit untuk semua Foreign Key di tabel tersebut, bukan mengandalkan konvensi penamaan Laravel.

Contoh 2: Migration Lanjutan (Foreign Keys)

Salah satu tugas terpenting adalah menjaga integritas data melalui Foreign Key Constraints. Misalnya, menghubungkan tabel products ke tabel categories.

// 2025_11_03_000001_add_category_id_to_products_table.php

public function up(): void
{
    Schema::table('products', function (Blueprint $table) {
        // 1. Tambahkan kolom FK
        $table->foreignId('category_id') // Alias untuk unsignedBigInteger
              ->nullable()
              ->constrained() // Secara default mencari tabel 'categories'
              ->onUpdate('cascade') // Saat kategori diupdate, ID di sini ikut update
              ->onDelete('set null'); // Jika kategori dihapus, set ID di sini menjadi NULL
    });
}

public function down(): void
{
    Schema::table('products', function (Blueprint $table) {
        // 1. Hapus constraint (wajib duluan)
        $table->dropConstrainedForeignId('category_id'); 
        
        // 2. Hapus kolom
        $table->dropColumn('category_id');
    });
}

// 2025_11_03_000001_add_category_id_to_products_table.php

public function up(): void
{
    Schema::table('products', function (Blueprint $table) {
        // 1. Tambahkan kolom FK
        $table->foreignId('category_id') // Alias untuk unsignedBigInteger
              ->nullable()
              ->constrained() // Secara default mencari tabel 'categories'
              ->onUpdate('cascade') // Saat kategori diupdate, ID di sini ikut update
              ->onDelete('set null'); // Jika kategori dihapus, set ID di sini menjadi NULL
    });
}

public function down(): void
{
    Schema::table('products', function (Blueprint $table) {
        // 1. Hapus constraint (wajib duluan)
        $table->dropConstrainedForeignId('category_id'); 
        
        // 2. Hapus kolom
        $table->dropColumn('category_id');
    });
}

Tips: Menggunakan foreignId(‘kolom’) jauh lebih ringkas dan aman daripada menulis unsignedBigInteger(‘kolom’) lalu foreign(‘kolom’).

Manajemen Migration: Menjalankan, Memutar Balik, dan Bersih-Bersih

Setelah membuat migration laravel, saatnya mengeksekusinya. Pengelolaan lifecycle migration adalah aspek kunci dari laravel 12 yang harus dikuasai oleh setiap developer.

Menjalankan Migration

Perintah ini adalah yang paling sering Anda gunakan:

php artisan migrate

php artisan migrate

Perintah ini akan menjalankan metode up() dari semua file migration yang belum pernah dieksekusi.

Perintah Manajemen Penting:

• php artisan migrate:status: Melihat daftar migration dan statusnya (sudah dijalankan/belum).
• php artisan migrate –pretend: Melihat script SQL apa yang akan dieksekusi tanpa benar-benar menjalankannya ke database. Ini sangat berguna untuk debugging sebelum di-deploy ke produksi.
• php artisan migrate –force: Digunakan untuk menjalankan migration di lingkungan production tanpa meminta konfirmasi (gunakan dengan sangat hati-hati!).

Teknik Rollback (Memutar Balik Perubahan)

Kemampuan untuk memutar balik perubahan (rollback) adalah keunggulan utama. Ini akan menjalankan metode down() dari file migration yang terlibat.

• php artisan migrate:rollback: Memutar balik batch migration terakhir yang dijalankan.
• php artisan migrate:rollback –step=3: Memutar balik 3 migration terakhir.
• php artisan migrate:reset: Memutar balik semua migration.

Menggunakan migrate:fresh dan schema:dump

Sebagai profesional, Anda harus tahu cara mengoptimalkan proses development dan deployment.

Memulai Ulang Database dengan Cepat (migrate:fresh)

Saat tahap development, sering kali Anda ingin menghapus semua data dan skema, lalu mengulang dari awal.

php artisan migrate:fresh          # Hapus semua tabel lalu migrate
php artisan migrate:fresh --seed   # Hapus, migrate, lalu jalankan seeder

php artisan migrate:fresh          # Hapus semua tabel lalu migrate
php artisan migrate:fresh --seed   # Hapus, migrate, lalu jalankan seeder

Perintah migrate:fresh jauh lebih cepat daripada migrate:reset diikuti oleh migrate, karena ia langsung menghapus semua tabel, bukan menjalankan satu per satu metode down().

Squashing Migrations dengan schema:dump

Seiring waktu, folder database/migrations Anda bisa membengkak hingga ratusan file. Ini memperlambat setup awal untuk developer baru. Laravel 12 memperkenalkan Migration Squashing menggunakan schema:dump.

php artisan schema:dump --prune

php artisan schema:dump --prune

Perintah ini:

1. Membuat file SQL tunggal (schema file) dari skema database Anda saat ini.
2. Menghapus semua file migration lama di folder database/migrations.

Ketika developer baru menjalankan migrate, Laravel akan mengeksekusi file SQL tunggal itu terlebih dahulu, membuat skema dasar dengan cepat, dan hanya menjalankan migration baru yang dibuat setelah dump terakhir. Ini adalah teknik deployment yang sangat bernilai.

Kesimpulan: Migrasi Laravel sebagai Pondasi Aplikasi

Anda telah melihat bagaimana Memahami migration laravel 12 adalah keterampilan fundamental yang mentransformasi workflow pengembangan database dari serangkaian tugas manual yang rawan error menjadi proses yang otomatis, dapat diulang, dan tervversi.

Migration bukan hanya tentang membuat migration laravel; ini adalah tentang menjaga kesehatan dan konsistensi aplikasi Anda di sepanjang lifecycle-nya. Baik saat Anda menggunakan migration di laravel untuk membuat skema baru atau melakukan edit tabel dengan migration laravel yang sudah ada, Anda kini memiliki perangkat yang kuat di tangan Anda.