Part 2 — Membuat Migration Tabel Kelas pada Laravel 13
📚 Pendahuluan
Pada Part 1, kita sudah berhasil membuat project Laravel dan database MySQL dengan nama akademik.
Sekarang kita mulai membangun struktur database untuk Sistem Informasi Akademik.
Tabel pertama yang akan kita buat adalah:
kelas
Tabel kelas akan digunakan untuk menyimpan informasi kelas siswa seperti nama kelas, tingkat, jurusan, dan tahun ajaran.
Project Laravel
↓
Model Kelas
↓
Migration Kelas
↓
Struktur Tabel
↓
php artisan migrate
↓
Cek HeidiSQL
🎯 Tujuan Praktikum
Setelah menyelesaikan praktikum ini, siswa diharapkan mampu:
- Memahami konsep Migration Laravel.
- Membuat Model menggunakan Artisan.
- Membuat Migration tabel kelas.
- Menentukan field pada tabel.
- Menjalankan Migration.
- Mengecek tabel melalui HeidiSQL.
📖 1. Apa Itu Migration?
Migration adalah mekanisme Laravel yang digunakan untuk membuat dan mengatur struktur database menggunakan kode program.
Dengan Migration, kita tidak harus selalu membuat tabel secara manual melalui HeidiSQL.
Misalnya kita ingin membuat tabel:
kelas
Kita dapat mendefinisikan struktur tabel tersebut menggunakan file Migration Laravel.
↓
LARAVEL
↓
MYSQL
↓
TABEL KELAS
🗃️ 2. Merancang Tabel Kelas
Sebelum membuat Migration, kita harus menentukan struktur tabel terlebih dahulu.
Struktur tabel kelas yang akan kita buat:
| Field | Tipe | Keterangan |
|---|---|---|
| id | BIGINT | Primary Key |
| nama_kelas | VARCHAR | Nama kelas |
| tingkat | VARCHAR | Tingkat kelas |
| jurusan | VARCHAR | Program keahlian |
| tahun_ajaran | VARCHAR | Tahun ajaran |
| created_at | TIMESTAMP | Waktu dibuat |
| updated_at | TIMESTAMP | Waktu diperbarui |
💻 3. Membuat Model dan Migration
Pastikan terminal berada di folder project:
C:\laragon\www\akademik
Jalankan perintah berikut:
php artisan make:model Kelas -m
Perintah tersebut terdiri dari:
| Bagian | Fungsi |
|---|---|
| php artisan | Menjalankan Laravel Artisan |
| make:model | Membuat Model |
| Kelas | Nama Model |
| -m | Membuat Migration |
app/Models/Kelas.php
database/migrations/
xxxx_xx_xx_xxxxxx_create_kelas_table.php
📂 4. Mengenal Model Kelas
Buka file:
app/Models/Kelas.php
Secara sederhana, Model digunakan sebagai representasi tabel database dalam aplikasi Laravel.
Untuk tahap ini kita belum perlu menambahkan kode khusus pada Model.
<?php
namespace App\Models;
use Illuminate\Database\Eloquent\Model;
class Kelas extends Model
{
//
}
📝 5. Membuka File Migration
Selanjutnya buka folder:
database/migrations
Cari file yang memiliki nama:
create_kelas_table.php
Nama file memiliki timestamp di bagian depan. Contohnya:
2026_10_01_000000_create_kelas_table.php
💻 6. Membuat Struktur Tabel Kelas
Isi bagian Migration dengan kode berikut:
<?php
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;
return new class extends Migration
{
public function up(): void
{
Schema::create('kelas', function (Blueprint $table) {
$table->id();
$table->string('nama_kelas');
$table->string('tingkat', 10);
$table->string('jurusan');
$table->string('tahun_ajaran', 20);
$table->timestamps();
});
}
public function down(): void
{
Schema::dropIfExists('kelas');
}
};
🔍 7. Memahami Kode Migration
Schema::create()
Schema::create('kelas', function (Blueprint $table) {
});
Digunakan untuk membuat tabel baru dengan nama:
kelas
$table->id()
$table->id();
Membuat kolom id yang digunakan sebagai primary key.
$table->string()
$table->string('nama_kelas');
Membuat kolom bertipe string.
Kolom tingkat
$table->string('tingkat', 10);
Digunakan untuk menyimpan data seperti:
X
XI
XII
Kolom jurusan
$table->string('jurusan');
Digunakan untuk menyimpan nama jurusan.
Contoh:
PPLG
TJKT
AKL
MPLB
Kolom tahun ajaran
$table->string('tahun_ajaran', 20);
Digunakan untuk menyimpan tahun ajaran.
Contoh:
2026/2027
created_at dan updated_at
$table->timestamps();
Perintah tersebut membuat dua kolom:
created_at
updated_at
Laravel akan menggunakan kolom tersebut untuk mencatat waktu pembuatan dan perubahan data.
🗑️ 8. Memahami Method down()
Pada Migration terdapat method:
public function down(): void
{
Schema::dropIfExists('kelas');
}
Method down() digunakan ketika Migration dibatalkan atau di-rollback.
Dalam contoh tersebut, Laravel akan menghapus tabel:
kelas
🚀 9. Menjalankan Migration
Setelah kode Migration selesai, simpan file.
Kemudian jalankan:
php artisan migrate
Jika berhasil, Laravel akan menjalankan Migration dan membuat tabel kelas pada database akademik.
Sekarang tabel kelas sudah tersedia di database.
🖥️ 10. Mengecek Tabel di HeidiSQL
Buka HeidiSQL.
Pilih database:
akademik
Kemudian refresh database.
Seharusnya muncul:
akademik
│
├── cache
├── jobs
├── kelas
├── migrations
├── sessions
└── users
🔍 11. Melihat Struktur Tabel Kelas
Klik tabel:
kelas
Kemudian lihat bagian struktur tabel.
Hasilnya kurang lebih:
| Field | Type | Key |
|---|---|---|
| id | BIGINT | PRIMARY |
| nama_kelas | VARCHAR | |
| tingkat | VARCHAR | |
| jurusan | VARCHAR | |
| tahun_ajaran | VARCHAR | |
| created_at | TIMESTAMP | |
| updated_at | TIMESTAMP |
📝 12. Memasukkan Data Kelas
Untuk memastikan tabel berhasil dibuat, kita dapat memasukkan data menggunakan HeidiSQL.
Jalankan SQL:
INSERT INTO kelas
(nama_kelas, tingkat, jurusan, tahun_ajaran)
VALUES
('XI PPLG 1', 'XI', 'PPLG', '2026/2027'),
('XI PPLG 2', 'XI', 'PPLG', '2026/2027'),
('XII PPLG 1', 'XII', 'PPLG', '2026/2027');
Kemudian:
SELECT * FROM kelas;
1 | XI PPLG 1 | XI | PPLG | 2026/2027
2 | XI PPLG 2 | XI | PPLG | 2026/2027
3 | XII PPLG 1 | XII | PPLG | 2026/2027
↩️ 13. Mencoba Rollback Migration
Laravel memungkinkan kita membatalkan Migration.
Jalankan:
php artisan migrate:rollback
Migration terakhir akan dibatalkan.
Jika Migration kelas merupakan Migration terakhir, tabel kelas akan dihapus.
Jangan menjalankan rollback pada database penting tanpa memahami Migration yang akan dibatalkan.
🔄 14. Membuat Kembali Tabel Kelas
Setelah melakukan rollback, jalankan kembali:
php artisan migrate
Tabel kelas akan dibuat kembali.
⚠️ 15. Error yang Sering Terjadi
❌ Error: Table already exists
SQLSTATE[42S01]:
Table 'kelas' already exists
Artinya tabel kelas sudah ada di database.
Jika masih dalam tahap pembelajaran, salah satu solusi adalah:
php artisan migrate:rollback
kemudian:
php artisan migrate
❌ Error: Migration tidak ditemukan
Pastikan file Migration berada di:
database/migrations
❌ Error database
Pastikan konfigurasi pada:
.env
sudah benar.
📋 16. Checklist Praktikum 2
- Project Laravel dapat dijalankan.
- Database akademik sudah tersedia.
- Model Kelas berhasil dibuat.
- Migration Kelas berhasil dibuat.
- Field tabel kelas sudah sesuai.
- php artisan migrate berhasil.
- Tabel kelas muncul di HeidiSQL.
- Struktur tabel kelas sudah benar.
- Data kelas berhasil dimasukkan.
- Siswa memahami fungsi migration.
📝 17. Tugas Praktikum
Tugas 1
Buat Model dan Migration:
php artisan make:model Kelas -m
Tugas 2
Buat struktur tabel dengan field:
id
nama_kelas
tingkat
jurusan
tahun_ajaran
created_at
updated_at
Tugas 3
Jalankan:
php artisan migrate
Tugas 4
Masukkan minimal 5 data kelas.
Tugas 5
Dokumentasikan:
-
Command
make:model - File Migration.
-
Hasil
php artisan migrate. - Struktur tabel di HeidiSQL.
- Data tabel kelas.
🏆 Indikator Keberhasilan
Membuat Model dan Migration Kelas, menentukan struktur field tabel, menjalankan Migration, serta memastikan tabel kelas berhasil dibuat pada database MySQL.
📌 Penutup
Pada Part 2 kita telah berhasil membuat Migration tabel kelas menggunakan Laravel 13.
Kita juga sudah mempelajari bagaimana Laravel mengubah kode Migration menjadi struktur tabel MySQL.
Konsep ini akan menjadi dasar penting untuk membuat seluruh tabel pada Sistem Informasi Akademik.
Pada tahap berikutnya kita akan membuat Migration Tabel Guru.
Laravel 13 • MySQL • Laragon • HeidiSQL • PPLG / RPL
.png)
0Komentar