Download the PHP package sejator/ws-server-php without Composer
On this page you can find all versions of the php package sejator/ws-server-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download sejator/ws-server-php
More information about sejator/ws-server-php
Files in sejator/ws-server-php
Package ws-server-php
Short Description PHP SDK untuk publish event ke WebSocket Server melalui HTTP dengan HMAC SHA256 signature.
License MIT
Informations about the package ws-server-php
๐ WS Server PHP SDK --- Publisher
PHP SDK untuk mengirim event (publish) ke WebSocket Server melalui HTTP webhook dengan autentikasi HMAC SHA256 Signature.
Cocok untuk
- Backend PHP (Laravel, CodeIgniter, native PHP)
- Trigger event realtime (order, chat, notifikasi)
- Komunikasi server-to-server (backend โ WebSocket server)
๐ฆ Instalasi
Install via Composer:
Struktur SDK
- Namespace utama:
Sejator\WebSocket - Class publik utama:
Sejator\WebSocket\WsServer
Internal: - Signature generator - HTTP client - Payload validator - Exception handler
๐ Contoh Penggunaan
๐ก Cara Kerja Publish Event
1๏ธโฃ Payload yang dikirim ke WebSocket server
2๏ธโฃ Signature HMAC SHA256 dibuat otomatis
3๏ธโฃ HTTP Request
4๏ธโฃ Server memverifikasi
- Signature
- Timestamp
๐งพ Method Reference
publish
| Parameter | Tipe | Keterangan |
|---|---|---|
| channel | string | Nama channel |
| event | string | Nama event |
| data | array / string | Payload event |
โ Catatan\
data harus berupa array atau string.
โ ๏ธ Aturan Channel & Event
Channel
Contoh:
ordersprivate-user-123presence-room-general
Event
WAJIB menggunakan titik (.) sebagai pemisah
Contoh valid:
order.createdmessage.sent
Contoh tidak valid:
order createdorder_createdws:order.created
๐ Implementasi (SDK untuk @sejator/ws-server)
@sejator/ws-server merupakan WebSocket Server yang berfungsi sebagai jembatan komunikasi realtime antara Publisher dan Subscriber.
SDK PHP ini berperan sebagai Publisher, sedangkan
@sejator/ws-client berperan sebagai Subscriber.
Keduanya mengikuti protokol, event, dan format payload yang sama, sehingga:
โจ Keunggulan
- โ Plug & Play (tanpa konfigurasi rumit)
- โ
Auto kompatibel dengan:
- Channel system
- Private channel authentication
- Heartbeat & pong
- Reconnect strategy
๐ซ Batasan
- โ Tidak ditujukan untuk WebSocket server lain.
โ ๏ธ PENTING
Pastikan backend WebSocket kamu menggunakan @sejator/ws-server, karena:
- Event internal seperti:
connect_successauth_failedpong- dll
- Struktur autentikasi:
APP_KEY:signature - Endpoint default:
/ws
Semuanya bergantung pada implementasi server tersebut.
๐ Arsitektur Publisher โ Server โ Client
โ๏ธ Alur Kerja End-to-End
- Backend PHP mem-publish event menggunakan SDK ini
@sejator/ws-servermemverifikasi:- Signature
- Timestamp
- Server meneruskan event ke channel terkait
- Client (
@sejator/ws-client) menerima event secara realtime - Event dipetakan langsung ke listener frontend
๐ Keamanan
- Signature dibuat otomatis menggunakan HMAC SHA256
- WebSocket server memverifikasi:
- Signature
- Timestamp
โ Rekomendasi
- Simpan
APP_KEY&APP_SECRETdi ENV - Gunakan HTTPS
- Batasi timestamp drift (ยฑ5 menit)