Gratis update & dukungan instalasi

Tutorial Website 11 Nov 2026

Cara Membuat Notifikasi In-App di Laravel: Database Notifications + Ikon Lonceng (Panduan 2026)

R Oleh renz mobellgnd
Cara Membuat Notifikasi In-App di Laravel: Database Notifications + Ikon Lonceng (Panduan 2026)

Cara Membuat Notifikasi In-App di Laravel: Database Notifications + Ikon Lonceng (Panduan 2026)

Notifikasi in-app di Laravel dibuat dengan channel database: jalankan php artisan make:notifications-table lalu migrate, buat class notifikasi dengan method toDatabase(), kirim lewat $user->notify(), lalu tampilkan lewat relasi unreadNotifications lengkap dengan hitungan belum dibaca dan tombol tandai sudah dibaca. Pengguna tidak perlu membuka email atau WhatsApp untuk tahu ada pesanan baru, pembayaran masuk, atau status berubah.

Apa itu database notification di Laravel?

Database notification adalah notifikasi yang disimpan sebagai baris di tabel notifications, bukan dikirim ke luar aplikasi. Setiap baris menyimpan tipe notifikasi, identitas penerima (notifiable_type dan notifiable_id), isi dalam kolom data berformat JSON, serta read_at yang bernilai null sampai pengguna membacanya. Karena datanya tersimpan, aplikasi bisa menampilkan riwayat notifikasi, menghitung yang belum dibaca, dan menandai satu per satu atau sekaligus — persis seperti ikon lonceng di marketplace, aplikasi kasir, atau dashboard admin.

Dokumentasi resmi Laravel menjelaskan channel ini di laravel.com/docs/notifications: channel database menyimpan informasi notifikasi di tabel database sehingga bisa ditanyakan kembali untuk ditampilkan di antarmuka aplikasi.

Kapan memakai notifikasi database, email, atau WhatsApp?

Ketiganya bukan saling menggantikan; mereka menjawab kebutuhan berbeda. Notifikasi database cocok untuk pesan yang harus dilihat saat pengguna sedang membuka aplikasi. Email cocok untuk bukti dan arsip. WhatsApp cocok untuk pesan mendesak yang harus sampai meski aplikasi tidak dibuka.

Kebutuhan Channel yang tepat Alasan
Pesanan baru, pembayaran masuk, stok menipisDatabase (in-app)Dilihat di dashboard, ada riwayatnya
Invoice, bukti pembayaran, reset passwordEmailPerlu arsip dan bisa dibuka kapan saja
Tagihan jatuh tempo, OTP, konfirmasi mendesakWhatsAppSampai meski aplikasi tidak dibuka
Aktivitas yang perlu diauditDatabase + activity logRiwayat tersimpan dan bisa ditelusur

Praktik yang paling masuk akal untuk source code toko atau kasir: kirim database sebagai utama, lalu tambahkan email atau WhatsApp hanya untuk peristiwa penting. Untuk pengiriman WhatsApp, pola antreannya sudah dibahas di artikel Cara Kirim Notifikasi WhatsApp Otomatis di Laravel, dan untuk email, lihat Cara Kirim Email Otomatis di Laravel dengan Queue.

Bagaimana cara membuat notifikasi database di Laravel?

Langkah 1: Buat tabel notifications

Laravel menyediakan perintah khusus untuk membuat migrasi tabel notifikasi. Perintah ini berbeda dengan perintah lama notifications:table yang masih muncul di banyak tutorial lawas — di Laravel 11 dan 12, gunakan make:notifications-table.

php artisan make:notifications-table
php artisan migrate

Perintah pertama membuat file migrasi untuk tabel notifications dengan kolom id, type, notifiable_type, notifiable_id, data, read_at, dan timestamps. Perintah kedua mengeksekusinya. Jangan mengedit struktur bawaan ini kecuali benar-benar perlu, karena relasi bawaan Laravel mengandalkannya.

Langkah 2: Pastikan model User memakai trait Notifiable

Model User bawaan Laravel sudah memakai trait Notifiable. Periksa app/Models/User.php dan pastikan baris ini ada:

use Illuminate\Notifications\Notifiable;

class User extends Authenticatable
{
use HasFactory, Notifiable;
}

Trait inilah yang memberi model relasi notifications, readNotifications, dan unreadNotifications, plus method notify(). Tanpa trait ini, pemanggilan $user->notify() akan gagal. Model lain — misalnya Admin atau Member — bisa memakai trait yang sama bila mereka juga perlu menerima notifikasi.

Langkah 3: Buat class notifikasi dengan toDatabase()

Buat class notifikasi untuk satu peristiwa bisnis, misalnya pesanan baru masuk. Satu class untuk satu peristiwa membuat isi notifikasi mudah diubah tanpa menyentuh controller.

php artisan make:notification OrderBaruMasuk

Lalu isi method via() dengan channel database, dan method toDatabase() dengan data JSON yang akan disimpan:

<?php

namespace App\Notifications;

use Illuminate\Bus\Queueable;
use Illuminate\Notifications\Notification;

class OrderBaruMasuk extends Notification
{
use Queueable;

public function __construct(public $order) {}

public function via(object $notifiable): array
{
return ['database'];
}

public function toDatabase(object $notifiable): array
{
return [
'title' => 'Pesanan baru masuk',
'message' => "Pesanan #{$this->order->id} senilai Rp " .
number_format($this->order->total, 0, ',', '.') .
' menunggu diproses.',
'order_id' => $this->order->id,
'url' => '/admin/orders/' . $this->order->id,
];
}
}

Tiga disiplin yang menjaga notifikasi tetap awet: simpan id dan url tujuan, bukan hanya teks, supaya notifikasi tetap bisa diklik walau teksnya berubah; simpan angka mentah (order_id, total) bukan teks yang sudah diformat, supaya bisa dipakai ulang; dan jangan simpan data sensitif seperti token, kata sandi, atau nomor kartu di kolom data, karena kolom ini mudah dibaca lewat query.

Langkah 4: Kirim notifikasi dari tempat peristiwa terjadi

Kirim notifikasi di titik yang sama dengan peristiwa bisnisnya — setelah order tersimpan, setelah pembayaran terverifikasi, setelah status berubah. Jangan mengirim dari view atau dari scheduler yang menebak-nebak.

use App\Notifications\OrderBaruMasuk;
use App\Models\User;

$admin = User::where('role', 'admin')->first();
$admin->notify(new OrderBaruMasuk($order));

Untuk banyak penerima sekaligus, gunakan facade Notification agar tidak perlu loop manual:

use Illuminate\Support\Facades\Notification;

$admins = User::where('role', 'admin')->get();
Notification::send($admins, new OrderBaruMasuk($order));

Pola yang lebih rapi lagi adalah memicu notifikasi dari event atau observer model, misalnya observer Order yang mengirim notifikasi saat status berubah dari pending menjadi paid. Dengan begitu, controller tetap pendek dan notifikasi tidak tertinggal bila order dibuat dari jalur lain, misalnya impor atau API. Bila peristiwa yang sama juga perlu dicatat sebagai jejak audit — siapa mengubah apa dan kapan — pisahkan tanggung jawabnya: notifikasi untuk memberi tahu, activity log untuk mencatat. Cara membangun jejak audit itu dibahas di artikel Cara Membuat Activity Log di Laravel.

Langkah 5: Tampilkan ikon lonceng dengan jumlah belum dibaca

Di layout utama, ambil hitungan notifikasi belum dibaca dan daftar terbarunya, lalu tampilkan sebagai dropdown lonceng. Contoh Blade berikut memakai relasi bawaan dan menandai notifikasi sudah dibaca saat diklik:

// Di controller atau view composer
$unreadCount = auth()->user()->unreadNotifications()->count();
$notifications = auth()->user()->notifications()->latest()->take(10)->get();
<div class="notification-bell">
<button>🔔 {{ $unreadCount > 0 ? $unreadCount : '' }}</button>
<ul>
@forelse ($notifications as $notification)
<li>
<a href="{{ $notification->data['url'] ?? '#' }}">
<strong>{{ $notification->data['title'] }}</strong>
<span>{{ $notification->data['message'] }}</span>
</a>
</li>
@empty
<li>Belum ada notifikasi.</li>
@endforelse
</ul>
</div>

Perhatikan dua hal di sini. Pertama, unreadNotifications() dan notifications() adalah relasi Eloquent biasa, jadi bisa dipadukan dengan latest(), take(), dan pagination seperti query lain. Kedua, selalu sediakan fallback (?? '#') untuk url, karena notifikasi lama mungkin tidak punya kunci itu bila struktur data pernah berubah.

Langkah 6: Tandai sudah dibaca dan bersihkan notifikasi lama

Sediakan endpoint untuk menandai satu notifikasi dan semua notifikasi sekaligus. Laravel menyediakannya lewat method markAsRead():

// Tandai satu notifikasi sudah dibaca
auth()->user()->notifications()
->where('id', $id)
->firstOrFail()
->markAsRead();

// Tandai semua notifikasi sudah dibaca
auth()->user()->unreadNotifications->markAsRead();

Catatan keamanan: selalu batasi query ke notifikasi milik pengguna yang sedang login (auth()->user()->notifications()), jangan pernah memakai DatabaseNotification::find($id) mentah — itu memungkinkan satu pengguna menandai atau membaca notifikasi pengguna lain hanya dengan menebak ID.

Terakhir, tabel notifications bisa membengkak cepat di aplikasi ramai. Tambahkan pembersihan berkala lewat scheduler, misalnya menghapus notifikasi yang sudah dibaca dan berumur lebih dari 90 hari:

// Di app/Console/Kernel.php atau routes/console.php (Laravel 11+)
Schedule::call(function () {
DB::table('notifications')
->whereNotNull('read_at')
->where('created_at', '<', now()->subDays(90))
->delete();
})->daily();

Pangkas yang sudah dibaca saja; notifikasi belum dibaca jangan pernah dihapus otomatis, karena itu sama dengan menghilangkan pesan yang belum sampai.

Apakah notifikasi database butuh queue dan realtime?

Tidak wajib, tapi keduanya layak dipertimbangkan begitu volume naik. Menambahkan interface ShouldQueue pada class notifikasi membuat penyimpanan berjalan di antrean, sehingga request checkout tidak melambat hanya karena harus mengirim notifikasi ke banyak admin. Ini penting bila satu peristiwa memicu puluhan penerima sekaligus.

Realtime — misalnya lonceng yang ter-update tanpa refresh — adalah lapisan terpisah. Database notification sendiri bersifat pasif: ia baru terlihat saat halaman dimuat ulang atau saat aplikasi mempoll endpoint notifikasi. Bila butuh update seketika, tambahkan broadcasting (Laravel Reverb atau Pusher) di atasnya, bukan mengganti channel database. Urutan yang benar: database dulu sampai sistemnya jalan, realtime belakangan bila memang dibutuhkan.

Cara ini tidak cocok jika...

Cara ini tidak cocok jika pesan harus sampai ke pengguna yang sedang tidak membuka aplikasi — untuk itu pakai email atau WhatsApp. Cara ini juga tidak cocok untuk pesan yang wajib punya bukti pengiriman di luar sistem, seperti pemberitahuan hukum atau tagihan resmi, karena notifikasi in-app bisa terhapus atau terlewat. Dan jangan memakai channel database untuk data yang berubah cepat dan tidak perlu riwayat, misalnya posisi kurir real-time — itu ranah broadcasting, bukan tabel notifikasi.

Checklist sebelum dipakai di source code jualan

  1. Tabel notifications sudah dibuat lewat make:notifications-table, bukan perintah lama.
  2. Model penerima memakai trait Notifiable.
  3. Setiap peristiwa punya satu class notifikasi dengan title, message, url, dan ID referensi.
  4. Query notifikasi selalu dibatasi ke pengguna yang login.
  5. Ada tombol tandai sudah dibaca dan tandai semua.
  6. Scheduler pembersihan notifikasi lama sudah aktif.
  7. Class notifikasi memakai ShouldQueue bila penerimanya banyak.

Bila checklist ini lolos, fitur lonceng notifikasi bisa langsung jadi nilai jual source code: admin toko tahu ada pesanan baru tanpa mengecek email, dan pembeli tidak ketinggalan update status pesanannya. Untuk konteks yang lebih luas, pola yang sama — data ditampilkan di dashboard begitu peristiwa terjadi — juga dipakai pada Dashboard Statistik Penjualan di Laravel dengan Chart.js.

FAQ

Apa perbedaan notification dan flash message di Laravel?

Flash message hanya hidup satu request dan hilang setelah halaman berikutnya; cocok untuk konfirmasi "Data berhasil disimpan". Notification database tersimpan permanen di tabel notifications, punya riwayat, status dibaca, dan bisa dibuka kembali kapan saja.

Apakah tabel notifications harus dibuat manual?

Tidak. Jalankan php artisan make:notifications-table lalu php artisan migrate di Laravel 11/12. Perintah lama notifications:table dari tutorial lawas sudah tidak berlaku di versi terbaru.

Bagaimana cara mengambil hanya notifikasi yang belum dibaca?

Gunakan relasi unreadNotifications pada model yang memakai trait Notifiable, misalnya auth()->user()->unreadNotifications. Untuk hitungannya, pakai unreadNotifications()->count() agar query-nya ringan.

Bisakah satu notifikasi dikirim lewat database dan email sekaligus?

Bisa. Kembalikan kedua channel dari method via(): return ['database', 'mail'];, lalu tambahkan method toMail() di class yang sama. Isi pesannya boleh sama, tapi sesuaikan formatnya — email butuh salam dan tombol aksi, sedangkan database butuh judul singkat dan URL tujuan.

Apakah notifikasi database bisa dikirim ke banyak pengguna?

Bisa, dengan Notification::send($users, new NamaNotifikasi($data)). Untuk performa, tambahkan ShouldQueue pada class notifikasi agar pengiriman ke banyak penerima tidak memperlambat request utama.

Bagaimana cara menghapus notifikasi lama secara otomatis?

Jadwalkan penghapusan lewat scheduler Laravel, misalnya menghapus notifikasi yang sudah dibaca dan berumur lebih dari 90 hari setiap hari. Jangan hapus notifikasi yang belum dibaca, karena itu menghilangkan pesan yang belum sampai ke penerimanya.

Apakah notifikasi in-app langsung muncul tanpa refresh halaman?

Tidak secara bawaan. Channel database bersifat pasif dan baru terlihat saat halaman dimuat ulang atau aplikasi mempoll endpoint notifikasi. Untuk update seketika, tambahkan broadcasting seperti Laravel Reverb di atas channel database.