Muhammad Fari Madyan
Hire me
Laravel · bagian 1 dari 11

Membangun Ulang Aplikasi Laravel E-Learning: Perjalanan dari 5.2 ke Laravel Modern

Kisah upgrade platform e-learning legacy Laravel 5.2 ke Laravel modern dengan Filament, Livewire, dan best practices. Plus, preview series tutorial lengkap.

Muhammad Fari Madyan

· 5 menit baca

Read in English →

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:

PendekatanKelebihanKekurangan
Upgrade BertahapRisiko lebih rendah, kode yang ada tetap dipakai5.2 → 5.3 → 5.4 → ... → 12 (menyakitkan)
Rebuild TotalMulai dari awal, arsitektur modernEffort lebih besar di awal, butuh migrasi data

Saya memilih rebuild total. Alasannya:

  1. Loncatannya terlalu jauh: Laravel 5.2 ke 12 melewati 13 rilis major (5.3 sampai 5.8, lalu 6 sampai 12)
  2. Arsitekturnya sudah berevolusi: Laravel modern memakai pattern yang berbeda
  3. Tools yang lebih baik sudah tersedia: Filament, Livewire, dan Inertia belum ada pada 2017
  4. Kesempatan belajar: membangun dari nol berarti memahami setiap baris kode

Tech Stack Baru

Berikut yang saya gunakan untuk versi rebuild:

KomponenLama (2017)Baru (2026)
FrameworkLaravel 5.2Laravel 12
PHP5.68.3
Admin PanelCustom BladeFilament 3
FrontendjQuery + BootstrapLivewire 3 + Tailwind
AuthenticationCustomFilament panel auth + Spatie Permission
DatabaseMySQL 5.6MySQL 8 / PostgreSQL
TestingTidak ada 😅Pest PHP
DeploymentFTP (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:

PHP
// 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:

PHP
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:

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

SQL
-- 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

PHP
// 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:

PartTopikLink
1Pengenalan & Mengapa Saya Upgrade✅ Artikel ini
2Setup Laravel 12 + FilamentBaca →
3Desain Skema DatabaseBaca →
4Autentikasi & Role UserBaca →
5Membangun Sistem UjianBaca →
6Fitur Real-Time dengan LivewireBaca →
7Strategi TestingBaca →
8Deployment ke ProductionBaca →
9Perbaikan Issue Komunitas & CI/CDBaca →
10Penguatan Keamanan & Celah IDORBaca →

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.

BagikanLinkedInXWhatsApp

Ditulis oleh Muhammad Fari Madyan

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

Ajak kerja sama
tulisan lainKembali ke semua artikel →bagian 2 →Setup Laravel 12 dengan Filament Admin Panel

Muhammad Fari Madyan

Senior Backend Engineer building real-time, high-concurrency systems that hold up in production. Co-founder of LampungDev. Based in Bandar Lampung, Indonesia (UTC+7), working remote.

Work

Case studiesCahTixExam platform, 4 stacksOpen source

© 2026 Muhammad Fari Madyan

Designed and built by Muhammad Fari Madyan