Journal Hire Me

Journal

Laravel Doctor: Diagnostik Kesehatan Aplikasi Bawaan Framework

Rilis kedua yang menarik dari Laracon US 2026 adalah Laravel Doctor — command line tool resmi untuk memeriksa kesehatan aplikasi Laravel secara otomatis.

Siapa pun yang pernah membantu debug instalasi Laravel yang bermasalah pasti kenal ritualnya: cek file .env ada atau tidak, cek APP_KEY sudah di-generate, cek folder storage writable, cek konfigurasi queue. Selama ini semua itu dilakukan manual lewat checklist di kepala. Doctor mengubahnya jadi diagnostik otomatis yang terkodifikasi, jadi tidak perlu lagi menebak-nebak.

Yang membuatnya berguna bukan cuma daftar pemeriksaannya, tapi caranya melapor:

  • Enam status diagnostik: pass, notice, warn, fail, skip, atau error
  • Pemeriksaan menyeluruh — environment variable, versi PHP, dependensi Composer, konektivitas database, akses cache/queue/storage, sampai pengaturan keamanan
  • Sadar environment — misalnya queue sync dianggap wajar di local, tapi memicu warning di production
  • Bisa memperbaiki sendiri — kalau suatu masalah bisa diperbaiki otomatis, Doctor langsung melakukannya
  • Output multi-format — CLI biasa, JSON, anotasi GitHub Actions, sampai format yang dioptimalkan untuk agen AI
  • Bisa diperluas — paket pihak ketiga bisa mendaftarkan diagnostik kustomnya sendiri lewat service provider
  • Bisa dipanggil programatis lewat Doctor::run(), tidak harus lewat CLI

Butuh PHP 8.3+ dan Laravel 12 atau 13, berlisensi MIT dan tersedia di GitHub.

Fitur yang paling relevan buat saya justru dukungan anotasi GitHub Actions-nya — artinya pipeline CI bisa langsung gagal dengan pesan yang jelas kalau ada masalah konfigurasi produksi, alih-alih ketahuan setelah deploy. Ini jenis tooling "membosankan tapi penting" yang sering diremehkan sampai ada instalasi yang rusak di tengah malam dan tidak ada yang tahu harus mulai dari mana.

← Back to Journal