Masalahnya: Codebase Berusia 9 Tahun
Pada tahun 2017, saya membangun platform e-learning untuk ujian online di sebuah sekolah menengah pertama. Platform ini dibuat dengan Laravel 5.2 dan PHP 5.6, stack standar pada masa itu.
Kini, di tahun 2026, codebase tersebut masih dipakai. Aplikasinya memang masih berjalan, tetapi:
- 🔴 Kerentanan keamanan: Laravel 5.2 sudah bertahun-tahun tidak mendapat patch keamanan
- 🔴 PHP 5.6 sudah mati: kebanyakan penyedia hosting sudah tidak mendukungnya
- 🔴 Minim fitur modern: tidak ada update real-time dan pengalaman mobile-nya buruk
- 🔴 Mimpi buruk maintenance: dependencies sudah usang dan dokumentasinya minim
Sudah saatnya melakukan rebuild total.
Apa yang Sistem Asli Lakukan
Sebelum masuk ke detail upgrade, saya jelaskan dulu fungsi platform e-learning ini:
Untuk Siswa
- 📊 Dashboard: melihat kursus yang diikuti dan ujian yang akan datang
- 📝 Ujian Online: mengikuti ujian berbatas waktu dengan soal pilihan ganda
- 📈 Laporan Nilai: melihat hasil ujian dan progress secara keseluruhan
- 💬 Forum Diskusi: berinteraksi dengan guru dan teman sekelas
Untuk Guru
- 📚 Manajemen Ujian: membuat, mengedit, dan menjadwalkan ujian online
- ❓ Bank Soal: mengelola soal dengan berbagai tingkat kesulitan
- 📊 Analitik: melihat performa siswa dan mengidentifikasi area yang perlu ditingkatkan
- 📋 Penilaian Tugas: memeriksa dan menilai tugas yang dikumpulkan siswa
Strategi Upgrade
Saya mempertimbangkan dua pendekatan:
| Pendekatan | Kelebihan | Kekurangan |
|---|---|---|
| Upgrade Bertahap | Risiko lebih rendah, kode yang ada tetap dipakai | 5.2 → 5.3 → 5.4 → ... → 12 (menyakitkan) |
| Rebuild Total | Mulai dari awal, arsitektur modern | Effort lebih besar di awal, butuh migrasi data |
Saya memilih rebuild total. Alasannya:
- Loncatannya terlalu jauh: Laravel 5.2 ke 12 melewati 13 rilis major (5.3 sampai 5.8, lalu 6 sampai 12)
- Arsitekturnya sudah berevolusi: Laravel modern memakai pattern yang berbeda
- Tools yang lebih baik sudah tersedia: Filament, Livewire, dan Inertia belum ada pada 2017
- Kesempatan belajar: membangun dari nol berarti memahami setiap baris kode
Tech Stack Baru
Berikut yang saya gunakan untuk versi rebuild:
| Komponen | Lama (2017) | Baru (2026) |
|---|---|---|
| Framework | Laravel 5.2 | Laravel 12 |
| PHP | 5.6 | 8.3 |
| Admin Panel | Custom Blade | Filament 3 |
| Frontend | jQuery + Bootstrap | Livewire 3 + Tailwind |
| Authentication | Custom | Filament panel auth + Spatie Permission |
| Database | MySQL 5.6 | MySQL 8 / PostgreSQL |
| Testing | Tidak ada 😅 | Pest PHP |
| Deployment | FTP (iya, beneran) | GitHub Actions + VPS |
Keputusan Arsitektur Utama
1. Filament untuk Admin Panel
Alih-alih membangun admin CRUD custom dari nol, saya menggunakan Filament 3. Berikut yang ditawarkan Filament:
// Ini saja yang dibutuhkan untuk CRUD lengkap
class ExamResource extends Resource
{
protected static ?string $model = Exam::class;
public static function form(Form $form): Form
{
return $form->schema([
TextInput::make('title')->required(),
DateTimePicker::make('start_time'),
DateTimePicker::make('end_time'),
Select::make('subject_id')
->relationship('subject', 'name'),
]);
}
}
Yang dulu butuh 500+ baris kode custom pada 2017, kini cukup 50 baris dengan Filament.
2. Livewire untuk Ujian Real-Time
Sistem ujian lama memakai JavaScript polling untuk mengecek sisa waktu. Berikut versi Livewire-nya:
class TakeExam extends Component
{
public Exam $exam;
public int $timeRemaining;
public function mount(Exam $exam)
{
$this->exam = $exam;
$this->timeRemaining = $exam->duration_minutes * 60;
}
#[Computed]
public function isTimeUp(): bool
{
return $this->timeRemaining <= 0;
}
}
Hasilnya, update real-time tanpa perlu menulis kode WebSocket custom.
3. Testing Proper dari Hari Pertama
Codebase asli sama sekali tidak punya test. Versi baru menggunakan Pest PHP:
it('prevents students from taking expired exams', function () {
$exam = Exam::factory()->expired()->create();
$student = User::factory()->student()->create();
actingAs($student)
->get(route('exams.take', $exam))
->assertForbidden();
});
Setiap fitur diuji dulu sebelum dianggap "selesai".
Strategi Migrasi
Bagian yang paling tricky adalah migrasi data dari sistem lama. Berikut pendekatan saya:
Step 1: Export Data Lama
-- Export dari database MySQL lama
SELECT * FROM siswa INTO OUTFILE '/tmp/students.csv';
SELECT * FROM guru INTO OUTFILE '/tmp/teachers.csv';
SELECT * FROM ujian INTO OUTFILE '/tmp/exams.csv';
Step 2: Transform ke Skema Baru
// Laravel Seeder untuk migrasi
class MigrateOldDataSeeder extends Seeder
{
public function run(): void
{
$oldStudents = json_decode(
file_get_contents(database_path('legacy/students.json'))
);
foreach ($oldStudents as $old) {
User::create([
'name' => $old->nama_siswa,
'email' => $old->email ?? $old->nis . '@school.local',
'role' => 'student',
'legacy_id' => $old->id,
]);
}
}
}
Step 3: Validasi & Test
Jalankan kedua sistem secara paralel, bandingkan output, dan verifikasi integritas data.
Pelajaran yang Dipetik (Sejauh Ini)
1. Jangan Takut Rebuild
Kadang, refactor terbaik adalah rewrite. Codebase lama sudah menjalankan tugasnya, tetapi terus mempertahankannya hanya akan menimbulkan lebih banyak masalah dalam jangka panjang.
2. Laravel Modern Menyenangkan
Developer experience di Laravel 12 sangat menyenangkan. Artisan commands, Tinker, Laravel Herd: semuanya langsung bekerja dengan baik.
3. Dokumentasi Sambil Membangun
Saya menulis artikel ini sambil membangun aplikasinya. Cara ini memaksa saya menjelaskan setiap keputusan, dan sering kali justru memperlihatkan celah dalam cara berpikir saya.
Series Tutorial Lengkap
Artikel ini adalah Part 1 dari series yang mendokumentasikan seluruh proses rebuild:
| Part | Topik | Link |
|---|---|---|
| 1 | Pengenalan & Mengapa Saya Upgrade | ✅ Artikel ini |
| 2 | Setup Laravel 12 + Filament | Baca → |
| 3 | Desain Skema Database | Baca → |
| 4 | Autentikasi & Role User | Baca → |
| 5 | Membangun Sistem Ujian | Baca → |
| 6 | Fitur Real-Time dengan Livewire | Baca → |
| 7 | Strategi Testing | Baca → |
| 8 | Deployment ke Production | Baca → |
| 9 | Perbaikan Issue Komunitas & CI/CD | Baca → |
| 10 | Penguatan Keamanan & Celah IDOR | Baca → |
Repository
Codebase legacy asli tersedia di GitHub:
🔗 mfarim/laravel-elearning: 42 ⭐ | 15 fork
Versi baru akan dirilis sebagai repository terpisah setelah siap untuk production.
Kesimpulan
Upgrade aplikasi Laravel berusia 9 tahun bukan hanya soal mengganti nomor versi. Ini juga soal memikirkan ulang arsitektur, mengadopsi tools modern, dan membangun sesuatu yang bisa bertahan 7 tahun ke depan.
Kalau kamu menghadapi tantangan upgrade legacy yang serupa, semoga series ini bisa membantu. Jangan ragu menghubungi saya untuk bertanya atau berbagi pengalaman upgrade kamu sendiri!
Punya aplikasi Laravel legacy yang perlu di-upgrade? Saya menawarkan layanan konsultasi untuk modernisasi Laravel. Hubungi saya.

Ditulis oleh Muhammad Fari Madyan
Senior Backend Engineer dan co-founder LampungDev. Saya menuliskan apa yang saya bangun supaya orang lain bisa ikut belajar.
