Belajar Laravel #30: Broadcasting & Reverb — Fitur Real-Time Tanpa Layanan Pihak Ketiga

Di dua episode sebelumnya saya sudah menyentuh dua jalur antarmuka: Livewire di episode #26 dan Inertia.js + Vue di episode #27. Keduanya menyelesaikan masalah “halaman terasa hidup”. Tapi ada satu kasus yang belum tersentuh: data yang berubah di server tanpa ada yang melakukan apa-apa di browser. Notifikasi masuk, status pesanan berubah, teman mengetik di chat. Selama ini jawaban saya selalu sama — polling berkala dengan setInterval — dan jujur, cara itu mulai terasa memalukan di proyek yang sedang saya kerjakan. Catatan ini adalah hasil saya belajar jalur resmi Laravel: broadcasting dengan Reverb.

Diagram alur broadcasting Laravel dengan Reverb
Alur broadcasting: aplikasi melempar event, Reverb menyebarkannya lewat koneksi wss, dan browser memperbarui DOM tanpa memuat ulang halaman.

Polling: tukang pos yang mengetuk pintu tiap 5 detik

Analogi yang akhirnya membuat saya paham: polling itu seperti tukang pos yang mengetuk pintu setiap lima detik hanya untuk memastikan tidak ada surat. Sebagian besar kunjungan sia-sia, server kewalahan menerima pertanyaan yang jawabannya “belum ada apa-apa”, dan di detik ke-5 ada jeda sebelum pengguna menyadari sesuatu datang. Broadcasting membalik arahnya: server yang mengirim saat berita benar-benar ada, pengguna tinggal mendengarkan. Ini berarti bagi saya — biaya server justru bisa lebih murah untuk aplikasi yang ramai, karena koneksi yang dibuka sekali lalu dipakai dua arah.

Empat bagian yang harus saya pahami dulu

Sebelum menulis kode, saya catat dulu kosakatanya supaya tidak tertukar. Broadcasting Laravel punya empat bagian: event (apa yang terjadi di sisi server), channel (topik tempat event itu disiarkan), server WebSocket (penghubung koneksi), dan listener di frontend yang menerjemahkan event jadi perubahan DOM.

Jenis channelAwalanSiapa boleh dengarCocok untuk
Publictanpa awalansiapa sajaticker harga, pengumuman umum
Privateprivate-pengguna login + lolos otorisasinotifikasi pribadi
Presencepresence-seperti private, plus tahu siapa saja yang sedang onlinechat room, “3 orang melihat halaman ini”

Reverb: server WebSocket milik Laravel sendiri

Yang membuat saya akhirnya berani mencoba adalah Reverb. Dulu opsi real-time selalu berarti memasang layanan pihak ketiga (Pusher dan sejenisnya) atau mengurus server Node sendiri. Reverb adalah server WebSocket bawaan Laravel, jadi satu composer require dan satu proses Artisan sudah cukup — cocok untuk saya yang hosting-nya masih sederhana. Dokumentasi Laravel versi terbaru (13.x saat saya menulis) memakai satu perintah pemasangan: composer require laravel/reverb lalu php artisan install:broadcasting --reverb.

Perintah kedua melakukan banyak hal sekaligus: memasang paket, menulis konfigurasi config/reverb.php, menyiapkan file routes/channels.php, menambahkan variabel REVERB_* di .env, sampai memasang paket JavaScript laravel-echo dan pusher-js. Bagian pusher-js ini yang sempat bikin saya bingung — namanya tetap Pusher walaupun kita tidak memakai layanan Pusher, karena Reverb berbicara dengan protokol yang sama.

Event: satu class, satu metode

Sisi server terasa paling sederhana. Cukup satu class event yang mengimplementasikan ShouldBroadcast, lalu sebutkan channel dan data yang ingin dikirim. Saya sengaja menambahkan ShouldQueue supaya penyiaran tidak menahan request yang sedang berjalan — pelajaran dari episode #26 tentang menjaga request tetap ringan masih berlaku di sini.

use Illuminate\Broadcasting\InteractsWithSockets;
use Illuminate\Contracts\Broadcasting\ShouldBroadcast;
use Illuminate\Contracts\Broadcasting\ShouldQueue;
use Illuminate\Foundation\Events\Dispatchable;
use Illuminate\Queue\SerializesModels;

class OrderShipped implements ShouldBroadcast, ShouldQueue
{
    use Dispatchable, InteractsWithSockets, SerializesModels;

    public function __construct(public string $orderId, public string $status) {}

    public function broadcastOn(): array
    {
        return [
            new PrivateChannel('orders.' . auth()->id()),
        ];
    }

    public function broadcastAs(): string
    {
        return 'order.shipped';
    }
}

Penting: broadcastOn() mengembalikan tujuan siarannya, bukan logikanya. Kalau datanya ada di request, saya pindahkan ke konstruktor dan biarkan queue yang mengerjakan. Ini berarti bagi saya — handler request yang tadinya menulis lima baris kode notifikasi cukup berhenti di event(new OrderShipped(...)).

Channels.php: pintu yang dijaga auth

Channel private tidak otomatis aman hanya karena namanya berawalan private-. Yang menjaganya adalah file routes/channels.php, tempat setiap channel didefinisikan beserta siapa yang boleh masuk. Kalau callback mengembalikan false, koneksi ditolak sebelum satu pun pesan sampai.

use App\Models\Order;

Broadcast::channel('orders.{orderId}', function ($user, $orderId) {
    return (int) $user->id === (int) Order::find($orderId)?->user_id;
});

Saya menulis pola {orderId} dengan pemisah titik supaya cocok dengan channel bernama orders.42. Di sini saya sempat salah satu jam: callback dibuat selalu true, dan pesan punya pengguna lain bisa terbaca — untung ketahuan waktu menulis test, bukan waktu sudah rilis.

Frontend: Echo sebagai penerjemah

Di sisi browser, laravel-echo berperan sebagai penerjemah: dia memegang koneksi WebSocket, lalu menyalurkan event ke listener. Inisialisasinya saya taruh sekali di file bootstrap, bukan di tiap halaman.

import Echo from 'laravel-echo';
import Pusher from 'pusher-js';
window.Pusher = Pusher;

window.Echo = new Echo({
    broadcaster: 'reverb',
    key: import.meta.env.VITE_REVERB_APP_KEY,
    wsHost: import.meta.env.VITE_REVERB_HOST,
    wsPort: import.meta.env.VITE_REVERB_PORT ?? 80,
    wssPort: import.meta.env.VITE_REVERB_PORT ?? 443,
    forceTLS: (import.meta.env.VITE_REVERB_SCHEME ?? 'https') === 'https',
    enabledTransports: ['ws', 'wss'],
});

Echo.private(`orders.${userId}`)
    .listen('.order.shipped', (e) => {
        toast(`Pesanan ${e.orderId} berstatus ${e.status}`);
    });

Dua hal yang bikin saya tersandung di awal. Pertama, tanda titik sebelum nama event — itu berarti “pakai nama dari broadcastAs()“; tanpa titik, listener mengharapkan nama class event. Kedua, di lingkungan development Reverb berjalan sebagai proses terpisah (php artisan reverb:server), jadi kalau dashboard tidak pernah ter-update, yang harus saya cek dulu bukan kodenya, tapi apakah prosesnya nyala.

Yang masih harus saya pelajari

Satu batasan jujur: catatan ini saya tulis setelah mencoba Reverb di proyek lokal, bukan di produksi. Di produksi ada pertanyaan yang belum saya jawab sendiri — jumlah koneksi WebSocket yang ditahan satu proses PHP, kebutuhan TLS supaya browser mengizinkan wss://, dan bagaimana bersikap saat koneksi terputus (Echo menyediakan callback onDisconnect/onReconnect, tapi strategi reconnect-nya belum saya uji di jaringan yang buruk). Untuk skala kecil dan menengah, saya cukup yakin jalur ini sudah memadai.

Ringkasnya: kalau di episode #26 dan #27 masalahnya adalah “halaman merespons aksi pengguna”, di episode ini masalahnya adalah “halaman merespons kejadian di server”. Tiga-duanya saya anggap bagian dari satu keahlian yang sama — menjaga pengguna tidak perlu menekan tombol muat ulang.

Sumber

Tinggalkan Balasan

Alamat email Anda tidak akan dipublikasikan. Ruas yang wajib ditandai *

Situs ini menggunakan Akismet untuk mengurangi spam. Pelajari bagaimana data komentar Anda diproses