PHP server for Laravel Echo broadcasting with Workerman.
The following are required to function properly.
- Laravel 5.3
- Redis 3+
Additional information on broadcasting with Laravel can be found on the official docs: Laravel-broadcasting
Install package with the following command:
$ composer require porygon/laravel-echo-serverRun command in your project directory:
$ php artisan vendor:publish --provider=Porygon\\LaravelEchoServer\\EchoServerServiceProviderthis command will publish a config file and a http-subscriber route file.
in your project root directory, run
$ php artisan laravel-echo-server startin your project root directory, run
$ laravel-echo-server stopEdit the default configuration of the server by adding options to your echo-server.php file.
- Your client side implementation must access the socket.io client from https.
- The server configuration must set the server host to use https.
- The server configuration should include paths to both your ssl certificate and key located on your server.
Note: This library currently only supports serving from either http or https, not both.
If you are struggling to get SSL implemented with this package, you could look at using a proxy module within Apache or NginX. Essentially, instead of connecting your websocket traffic to https://yourserver.dev:6001/socket.io?..... and trying to secure it, you can connect your websocket traffic to https://yourserver.dev/socket.io. Behind the scenes, the proxy module of Apache or NginX will be configured to intercept requests for /socket.io, and internally redirect those to your echo server over non-ssl on port 6001. This keeps all of the traffic encrypted between browser and web server, as your web server will still do the SSL encryption/decryption. The only thing that is left unsecured is the traffic between your webserver and your Echo server, which might be acceptable in many cases.
#the following would go within the server{} block of your web server config
location /socket.io {
proxy_pass http://laravel-echo-server:6001; #could be localhost if Echo and NginX are on the same box
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "Upgrade";
}
RewriteCond %{REQUEST_URI} ^/socket.io [NC]
RewriteCond %{QUERY_STRING} transport=websocket [NC]
RewriteRule /(.*) ws://localhost:6001/$1 [P,L]
ProxyPass /socket.io http://localhost:6001/socket.io
ProxyPassReverse /socket.io http://localhost:6001/socket.io
The Laravel Echo Server subscribes to incoming events with two methods: Redis & Http.
Your core application can use Redis to publish events to channels. The Laravel Echo Server will subscribe to those channels and broadcast those messages via socket.io.
Using Http, you can also publish events to the Laravel Echo Server in the same fashion you would with Redis by submitting a channel and message to the broadcast endpoint. You need to generate an API key as described in the API Clients section and provide the correct API key.
Request Endpoint
POST http://app.dev:6001/apps/your-app-id/events?auth_key=skti68i...
Request Body
{
"channel": "channel-name",
"name": "event-name",
"data": {
"key": "value"
},
"socket_id": "h3nAdb134tbvqwrg"
}channel - The name of the channel to broadcast an event to. For private or presence channels prepend private- or presence-.
channels - Instead of a single channel, you can broadcast to an array of channels with 1 request.
name - A string that represents the event key within your app.
data - Data you would like to broadcast to channel.
socket_id (optional) - The socket id of the user that initiated the event. When present, the server will only "broadcast to others".
The HTTP subscriber is compatible with the Laravel Pusher subscriber. Just configure the host and port for your Socket.IO server and set the app id and key in config/broadcasting.php. Secret is not required.
'pusher' => [
'driver' => 'pusher',
'key' => env('PUSHER_KEY'),
'secret' => null,
'app_id' => env('PUSHER_APP_ID'),
'options' => [
'host' => 'localhost',
'port' => 6001,
'scheme' => 'http'
],
],You can now send events using HTTP, without using Redis. This also allows you to use the Pusher API to list channels/users as described in the Pusher PHP library
The HTTP API exposes endpoints that allow you to gather information about your running server and channels.
Status Get total number of clients, uptime of the server, and memory usage.
GET /apps/:APP_ID/statusChannels List of all channels.
GET /apps/:APP_ID/channelsChannel Get information about a particular channel.
GET /apps/:APP_ID/channels/:CHANNEL_NAMEChannel Users List of users on a channel.
GET /apps/:APP_ID/channels/:CHANNEL_NAME/usersCross domain access can be specified in the laravel-echo-server.json file by changing allowCors in apiOriginAllow to true. You can then set the CORS Access-Control-Allow-Origin, Access-Control-Allow-Methods as a comma separated string (GET and POST are enabled by default) and the Access-Control-Allow-Headers that the API can receive.
Example below:
{
"apiOriginAllow": {
"allowCors": true,
"allowOrigin": "http://127.0.0.1",
"allowMethods": "GET, POST",
"allowHeaders": "Origin, Content-Type, X-Auth-Token, X-Requested-With, Accept, Authorization, X-CSRF-TOKEN, X-Socket-Id"
}
}This allows you to send requests to the API via AJAX from an app that may be running on the same domain but a different port or an entirely different domain.
To persist presence channel data, there is support for use of Redis or SQLite as a key/value store. The key being the channel name, and the value being the list of presence channel members.
Each database driver may be configured in the laravel-echo-server.json file under the databaseConfig property. The options get passed through to the database provider, so developers are free to set these up as they wish.
For example, if you wanted to pass a custom configuration to Redis:
{
"databaseConfig": {
"redis": {
"port": "3001",
"host": "redis.app.dev",
"keyPrefix": "my-redis-prefix"
}
}
}Note: No scheme (http/https etc) should be used for the host address
A full list of Redis options can be found here.
When users join a presence channel, their presence channel authentication data is stored using Redis.
While presence channels contain a list of users, there will be instances where a user joins a presence channel multiple times. For example, this would occur when opening multiple browser tabs. In this situation "joining" and "leaving" events are only emitted to the first and last instance of the user.
Optionally, you can configure laravel-echo-server to publish an event on each update to a presence channel, by setting databaseConfig.publishPresence to true:
{
"database": "redis",
"databaseConfig": {
"redis": {
"port": "6379",
"host": "localhost"
},
"publishPresence": true
}
}You can use Laravel's Redis integration, to trigger Application code from there:
Redis::subscribe(['PresenceChannelUpdated'], function ($message) {
var_dump($message);
});See the official Laravel documentation for more information. https://laravel.com/docs/master/broadcasting#introduction
You can include the socket.io client library from your running server. For example, if your server is running at app.dev:6001 you should be able to
add a script tag to your html like so:
<script src="//app.dev:6001/socket.io/socket.io.js"></script>
Note: When using the socket.io client library from your running server, remember to check that the io global variable is defined before subscribing to events.
µWebSockets has been officially deprecated. Currently there is no support for µWebSockets in Socket.IO, but it may have the new ClusterWS support incoming. Meanwhile Laravel Echo Server will use ws engine by default until there is another option.