Error & exception handling

Penanganan error yang baik menjawab dua pertanyaan berbeda sekaligus: apa yang perlu diketahui pengguna, dan apa yang perlu diketahui kamu. Keduanya jarang sama.

Konfigurasi terpusat

// bootstrap/app.php
->withExceptions(function (Exceptions $exceptions) {

    // Jangan penuhi log dengan hal yang memang wajar terjadi
    $exceptions->dontReport([PembayaranDitolak::class]);

    // Konteks tambahan untuk SETIAP laporan error
    $exceptions->context(fn () => [
        'tenant_id' => auth()->user()?->tenant_id,
    ]);

    // Bentuk respons untuk exception tertentu
    $exceptions->render(function (KuotaHabis $e, Request $request) {
        return $request->expectsJson()
            ? response()->json(['message' => $e->getMessage()], 429)
            : back()->with('galat', $e->getMessage());
    });
})

Exception domain: satu kelas, satu makna

class StokTidakCukup extends Exception
{
    public function __construct(
        public readonly Produk $produk,
        public readonly int $diminta,
    ) {
        parent::__construct("Stok {$produk->nama} tinggal {$produk->stok}, diminta {$diminta}.");
    }

    // Laravel memanggil ini otomatis saat exception lolos ke atas
    public function render(Request $request): Response
    {
        return $request->expectsJson()
            ? response()->json([
                'message'    => $this->getMessage(),
                'produk_id'  => $this->produk->id,
                'tersedia'   => $this->produk->stok,
              ], 409)
            : back()->withErrors(['jumlah' => $this->getMessage()]);
    }

    // Konteks yang ikut ke log
    public function context(): array
    {
        return ['produk_id' => $this->produk->id, 'diminta' => $this->diminta];
    }
}

Sekarang layanan domainmu cukup throw new StokTidakCukup($produk, 5). Tidak ada satu pun controller yang perlu tahu cara menampilkannya, dan bentuk responsnya konsisten di seluruh aplikasi.

Status HTTP yang sudah disediakan

APP_DEBUG di produksi

Dengan APP_DEBUG=true, halaman error Laravel menampilkan stack trace, potongan kode sumber, dan tabel berisi seluruh variabel environment — termasuk password database, kunci API, dan APP_KEY. Satu error 500 yang terlihat publik sudah cukup untuk membocorkan seluruh aplikasi.

# Wajib di produksi
APP_DEBUG=false
APP_ENV=production

Log yang berguna dibaca mesin

Log::info('pesanan dibuat', [
    'pesanan_id' => $pesanan->id,
    'total'      => $pesanan->total,
    'user_id'    => $pesanan->user_id,
]);

// Melaporkan tanpa menggagalkan permintaan
try {
    $pengirim->kirim($pesan);
} catch (Throwable $e) {
    report($e);          // masuk log & error tracker
    // permintaan tetap lanjut
}