Bab 2 — Migration dan Model

2.1Konsep

Migration = riwayat bentuk tabel

Daripada membuat tabel dengan klik-klik di phpMyAdmin, kita menulis migration: berkas kode yang menjelaskan bentuk tabel. Keuntungannya: bentuk tabel tercatat, bisa diulang di komputer lain, dan semua anggota kelompok punya tabel yang persis sama.

Model = jembatan ke satu tabel

Model Siswa mewakili tabel siswas. Laravel menebak nama tabel dari nama model (Siswa → siswas). Lewat model, kamu menyimpan dan membaca data dengan kode PHP seperti Siswa::all(), tanpa menulis SQL.

$fillable = daftar kolom yang boleh diisi

Saat kamu menulis Siswa::create([...]), Laravel hanya mau mengisi kolom yang tercantum di $fillable. Ini pagar keselamatan: kalau seseorang mengirim isian tambahan yang tidak kamu rencanakan, isian itu diabaikan atau ditolak.

2.2Langkah 1 — Buat model, migration, dan controller sekaligus

php artisan make:model Siswa -mcr

Perintah ini membuat tiga berkas sekaligus:

Buka folder proyek di VS Code dan temukan ketiga berkas itu sebelum lanjut. Nama berkas migration diawali tanggal dan jam, jadi berbeda di tiap komputer. Itu wajar.

2.3Langkah 2 — Isi migration

Buka berkas migration yang baru dibuat. Di dalamnya ada method up() (membuat tabel) dan down() (membatalkannya). Ganti isi method up() dengan kolom yang diminta Bu Rina:

📄 Berkas database/migrations/xxxx_create_siswas_table.php — ganti isi method up()

    public function up(): void    {        Schema::create('siswas', function (Blueprint $table) {            $table->id();            $table->string('nama');            $table->string('program_les');            $table->string('no_hp');            $table->timestamps();        });    }

Membaca kodenya:

Jalankan migration:

php artisan migrate

Laravel akan menjalankan migration yang belum pernah dijalankan. Kalau muncul pertanyaan bahwa berkas database belum ada dan apakah akan dibuatkan, jawab yes. Periksa hasilnya:

php artisan migrate:status

Migration create_siswas_table harus berstatus Ran.

2.4Langkah 3 — Isi model

Buka app/Models/Siswa.php dan tambahkan $fillable:

📄 Ganti seluruh isi berkas app/Models/Siswa.php

<?phpnamespace App\Models;use Illuminate\Database\Eloquent\Model;class Siswa extends Model{    protected $fillable = ['nama', 'program_les', 'no_hp'];}

2.5Uji coba lewat tinker

tinker adalah ruang percobaan: kamu mengetik kode PHP dan langsung melihat hasilnya.

php artisan tinker

Ketik baris demi baris (tanda > adalah prompt tinker, jangan diketik):

> use App\Models\Siswa;> Siswa::create(['nama' => 'Budi', 'program_les' => 'Coding', 'no_hp' => '081234567890']);> Siswa::all();> Siswa::count();

Hasil Siswa::all() harus menampilkan data Budi. Keluar dari tinker dengan exit.

💥 Galat yang sengaja dibuat: lupa $fillable

1. Di Siswa.php, beri komentar // di depan baris protected $fillable ..., lalu simpan.
2. Buka php artisan tinker lagi (tutup dulu yang lama dengan exit supaya kode terbaru terbaca).
3. Ulangi Siswa::create([...]) dengan data lain.

Kamu akan melihat galat MassAssignmentException. Tulis di bukumu: apa bunyi galatnya, dan apa artinya menurutmu? Kembalikan barisnya setelah selesai.

2.6Jalankan test

php artisan test --filter=ModelSiswaTest

Empat test memeriksa: tabel punya kolom yang diminta, create() menyimpan data, nomor HP yang diawali nol tetap utuh sebagai teks, dan kolom di luar $fillable (mis. id) tidak bisa diisi massal.

Harapannya: Tests: 4 passed. Angka assertions di sebelahnya boleh berbeda.