Saya mulai penasaran ketika mengerjakan proyek API backend. Dokumentasi Laravel menyebutkan dua paket autentikasi utama — Breeze dan Sanctum — tapi tidak langsung menjelaskan kapan harus memilih salah satunya.
Apa Bedanya Secara Fundamental?
Perbedaan intinya ada di bagaimana server "mengingat" siapa yang sedang login.
Breeze menggunakan session cookie. Setiap kali pengguna login, server membuat sebuah sesi dan menyimpannya (biasanya di database atau file). Browser kemudian menyimpan cookie kecil yang berisi ID sesi tersebut. Di setiap request berikutnya, server mencocokkan cookie itu dengan data sesi yang disimpan.
Sanctum menggunakan API token stateless. Server membuat token panjang dan memberikannya ke klien. Klien menyimpan token ini sendiri (biasanya di localStorage atau memory aplikasi) dan mengirimkannya di header setiap request. Server tidak menyimpan "state" — ia hanya memverifikasi bahwa token valid.
Kapan Pakai Breeze?
Gunakan Breeze jika aplikasi Anda adalah monolith tradisional di mana Blade merender semua halaman. Pengguna mengakses web lewat browser biasa.
Contoh: portofolio ini sendiri adalah web Blade — login admin tidak butuh API token sama sekali.
Kapan Pakai Sanctum?
Gunakan Sanctum jika Anda membangun SPA (React/Vue) atau aplikasi mobile yang berkomunikasi dengan backend Laravel lewat API.
Di OrderSync API, saya memilih Sanctum karena klien yang akan mengkonsumsi API adalah aplikasi eksternal. Konfigurasinya di level routing sangat sederhana:
Route::middleware('auth:sanctum')->group(function () {
Route::get('/orders', [OrderController::class, 'index']);
Route::post('/orders', [OrderController::class, 'store']);
});
Kesimpulan
Pilihan antara Breeze dan Sanctum bukan soal mana yang lebih baik, tapi soal konteks arsitektur aplikasi Anda. Breeze untuk web Blade tradisional, Sanctum untuk API yang dikonsumsi klien eksternal.