marcosraudkett / centrifuge-php
centrifuge-php
1.0.0
2024-06-06 10:50 UTC
Requires
- php: ^8.1
- illuminate/contracts: ^10.0
- saloonphp/saloon: ^3.0
- spatie/laravel-package-tools: ^1.14.0
Requires (Dev)
- larastan/larastan: ^2.0.1
- laravel/pint: ^1.0
- nunomaduro/collision: ^7.8
- orchestra/testbench: ^8.8
- pestphp/pest: ^2.20
- pestphp/pest-plugin-arch: ^2.0
- pestphp/pest-plugin-laravel: ^2.0
README
This is an unofficial Centrifugo PHP server SDK. More information on the official documentation page.
Requirements
- PHP 8.1+
Installation
composer require marcosraudkett/centrifuge-php
Usage
Publish
Example on how to publish data to a channel:
use Mvrc\CentrifugePhp\CentrifugeConnector; use Mvrc\CentrifugePhp\Requests\PublishRequest; $connector = new CentrifugeConnector; $request = new PublishRequest( channel: "private-test", data: [ "test" => true ] ); $response = $connector->send($request); print_r($response->json()); print_r($response->status());
Available requests
Request | Description |
---|---|
BatchRequest | Batch allows sending many commands in one request. |
BroadcastRequest | broadcast is similar to publish but allows to efficiently send the same data into many channels. |
ChannelsRequest | channels return active channels (with one or more active subscribers in it). |
DisconnectRequest | disconnect allows disconnecting a user by ID. |
HistoryRemoveRequest | history_remove allows removing publications in channel history. |
HistoryRequest | history allows getting channel history information (list of last messages published into the channel). |
InfoRequest | info method allows getting information about running Centrifugo nodes. |
PresenceRequest | presence allows getting channel online presence information (all clients currently subscribed on this channel). |
PresenceStatsRequest | presence_stats allows getting short channel presence information - number of clients and number of unique users (based on user ID). |
PublishRequest | Publish method allows publishing data into a channel (we call this message publication in Centrifugo). Most probably this is a command you'll use most of the time. |
RefreshRequest | refresh allows refreshing user connection (mostly useful when unidirectional transports are used). |
SubscribeRequest | subscribe allows subscribing active user's sessions to a channel. Note, it's mostly for dynamic server-side subscriptions. |
UnsubscribeRequest | unsubscribe allows unsubscribing user from a channel. |
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Feel free to open a pull request or report an issue.
Credits
License
The MIT License (MIT). Please see License File for more information.