Migrasi — skema sebagai kode

Migrasi membuat skema database jadi bagian dari kode yang ter-review. Yang membedakan proyek kecil dan enterprise adalah apa yang boleh kamu lakukan pada tabel yang sedang dipakai.

Bentuk sebuah migrasi

php artisan make:migration buat_tabel_produk
php artisan make:migration tambah_stok_ke_produk --table=produk

return new class extends Migration
{
    public function up(): void
    {
        Schema::create('produk', function (Blueprint $table) {
            $table->id();
            $table->foreignId('kategori_id')->constrained()->cascadeOnDelete();
            $table->string('nama', 120);
            $table->string('slug')->unique();          // unique index, bukan cuma validasi
            $table->unsignedBigInteger('harga');       // rupiah dalam satuan terkecil
            $table->unsignedInteger('stok')->default(0);
            $table->json('atribut')->nullable();
            $table->timestamps();                      // created_at, updated_at
            $table->softDeletes();                     // deleted_at

            $table->index(['kategori_id', 'created_at']);   // sesuai query yang nyata
        });
    }

    public function down(): void
    {
        Schema::dropIfExists('produk');
    }
};

Perintah yang perlu dibedakan

Jangan pakai model di dalam migrasi

// SALAH — model bisa berubah; migrasi ini akan rusak enam bulan lagi
public function up(): void
{
    Produk::whereNull('slug')->each(fn ($p) => $p->update(['slug' => Str::slug($p->nama)]));
}

// BENAR — query builder, terikat pada skema saat itu
public function up(): void
{
    DB::table('produk')->whereNull('slug')->orderBy('id')->chunkById(1000, function ($baris) {
        foreach ($baris as $b) {
            DB::table('produk')->where('id', $b->id)->update(['slug' => Str::slug($b->nama)]);
        }
    });
}

Alasannya: migrasi adalah catatan sejarah yang harus tetap bisa dijalankan dari nol bertahun-tahun kemudian. Model Produk hari ini mungkin punya global scope, cast, atau event yang belum ada saat migrasi itu ditulis — dan salah satunya bisa membuat migrasi gagal atau, lebih buruk, menulis data yang salah.

Perubahan yang memutus: expand & contract

Saat deploy berjalan, ada momen ketika kode versi lama dan versi baru berjalan bersamaan — di ECS itu justru kondisi normal selama rolling update. Karena itu, mengganti nama kolom dalam satu langkah pasti menimbulkan error. Pecah jadi tiga deploy:

Aturan turunannya, yang berlaku untuk setiap migrasi di aplikasi yang sedang hidup:

1. Kolom baru selalu nullable atau punya default — kode lama tidak tahu cara mengisinya.
2. Jangan pernah mengganti nama atau menghapus kolom dalam deploy yang sama dengan perubahan kodenya.
3. Backfill data dijalankan per potongan, bukan satu UPDATE raksasa yang mengunci tabel.
4. Menambah index di tabel besar butuh perhatian khusus — periksa dukungan operasi online di mesin databasemu.

Index: satu kalimat yang menghemat berjam-jam

Buat index untuk kolom yang muncul di where, join, dan order by — dan untuk kombinasinya, urutan kolom di index harus mengikuti urutan pemakaian. Ini dibahas lebih dalam di Fase 7, tapi kebiasaannya dimulai di sini: setiap kali menulis foreignId(), tanyakan apakah kamu juga akan menyaring berdasarkan kolom lain bersamanya.