2017 © Pedro Peláez
 

library stork

Virge::Stork is a library to help with PHP Based WebSockets, offering an abstraction above Ratchet to provide easy of implementation, horizontally scalable services, and per-topic subscription authentication

image

virge/stork

Virge::Stork is a library to help with PHP Based WebSockets, offering an abstraction above Ratchet to provide easy of implementation, horizontally scalable services, and per-topic subscription authentication

  • Saturday, July 7, 2018
  • by siosphere
  • Repository
  • 1 Watchers
  • 0 Stars
  • 188 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 1 Forks
  • 0 Open issues
  • 35 Versions
  • 4 % Grown

The README.md

Virge::Stork

Virge::Stork is a collection of services/components that provide a nice wrapper around Thruway (https://github.com/voryx/Thruway) that provides a horizontally scalable websocket architecture, and per topic subscription authentication for WAMP v2., (*1)

Architecture

Virge::Stork provides a scalable architecture that allows you to scale your websocket servers, and webservers independently, as well as support for load balancing of websocket servers., (*2)

Publish Server

Virge::Stork provides a ZMQ Publish server. This server subscribes to all available Websocket Servers, and will broadcast every push notification to all websocket servers., (*3)

Websocket Client

The websocket client subscribes to the ZMQ Publish server, when receiving messages from the ZMQ Publish Server it broadcasts to all subscribed., (*4)

Authentication Client

The Auth Client handles the authentication of clients, and their topic subscriptions., (*5)

Crossbar.io or other WAMP Router

Usage requires using crossbar.io or another compliant WAMP Router. Stork depends on a role that allows it to register two Procedures, (*6)

io.virge.stork.auth Used to provide basic ticket authentication to clients, (*7)

io.virge.stork.topic_auth Used to determine if the client can subscribe to a given topic, (*8)

Topics

Topics are a URI that follows the format:, (*9)

version.feedName.feedId

They are declared in Stork, and optionally attached to verifiers., (*10)

use Virge\Stork;
Stork::topic('v1', 'test')
    ->verify(function($session, $topic, $feedId, &$reason) {
        return true;
    })
;

The declared topics do not include the feedId, this is passed in by the client upon connection. It will be passed to the verifier and can be used in determining if the user can subscribe., (*11)

Authenticator

Virge::Stork provides the ability to have a custom authenticator callback for initial websocket connection. This authenticator should set the authId to a valid string (usually the UserId of the user connection), (*12)

This authId will be used in the topic authentication, (*13)

Stork::authenticator(function($session, &$returnData) {

    if($session->ticket === 'testtest') {
        $returnData['authid'] = "1";
        return true;
    }

    return false;
});

RPC *alpha

Virge::Stork provides the ability to register and call RPC methods. You start with a MethodController that will then register available RPC methods., (*14)

Checkout examples/simple/rpc_caller.php and rpc_provider.php for an example., (*15)

Running Examples

From within examples/simple you'll need to start 3 processes:, (*16)

php -f publish_server.php

php -f ws_client.php

php -f auth_client.php

You will also need to start a crossbar.io server, an example configuration is provided within examples/simple:, (*17)

docker run --name crossbar -p 8000:80 -e "CROSSBAR_BACKEND_SECRET=testtest" -v /abs/path/to/examples/simple/.crossbar:/app/.crossbar --entrypoint "crossbar start --cbdir /app/.crossbar" crossbario/crossbar

We can also start our webserver within that directory:, (*18)

php -S localhost:9000

Editing services.php will allow you to configure ports, and hostnames., (*19)

You should be able to visit http://localhost:9000 and it should attempt to connect to the websocket. Opening up the console will show debug information, and any connection errors., (*20)

You can then send push messages using:, (*21)

php -f push.php

The Versions

07/07 2018

3.x-dev

3.9999999.9999999.9999999-dev

Virge::Stork is a library to help with PHP Based WebSockets, offering an abstraction above Ratchet to provide easy of implementation, horizontally scalable services, and per-topic subscription authentication

  Sources   Download

MIT

The Requires

 

by Michael Kramer

07/07 2018

v3.1.1

3.1.1.0

Virge::Stork is a library to help with PHP Based WebSockets, offering an abstraction above Ratchet to provide easy of implementation, horizontally scalable services, and per-topic subscription authentication

  Sources   Download

MIT

The Requires

 

by Michael Kramer

07/07 2018

v3.1.0

3.1.0.0

Virge::Stork is a library to help with PHP Based WebSockets, offering an abstraction above Ratchet to provide easy of implementation, horizontally scalable services, and per-topic subscription authentication

  Sources   Download

MIT

The Requires

 

by Michael Kramer

27/02 2018

v3.0.2

3.0.2.0

Virge::Stork is a library to help with PHP Based WebSockets, offering an abstraction above Ratchet to provide easy of implementation, horizontally scalable services, and per-topic subscription authentication

  Sources   Download

MIT

The Requires

 

by Michael Kramer

27/02 2018

v3.0.1

3.0.1.0

Virge::Stork is a library to help with PHP Based WebSockets, offering an abstraction above Ratchet to provide easy of implementation, horizontally scalable services, and per-topic subscription authentication

  Sources   Download

MIT

The Requires

 

by Michael Kramer

27/02 2018

v3.0.0

3.0.0.0

Virge::Stork is a library to help with PHP Based WebSockets, offering an abstraction above Ratchet to provide easy of implementation, horizontally scalable services, and per-topic subscription authentication

  Sources   Download

MIT

The Requires

 

by Michael Kramer

27/02 2018

dev-master

9999999-dev

Virge::Stork is a library to help with PHP Based WebSockets, offering an abstraction above Ratchet to provide easy of implementation, horizontally scalable services, and per-topic subscription authentication

  Sources   Download

MIT

The Requires

 

The Development Requires

by Michael Kramer

23/09 2017

dev-pub-provider

dev-pub-provider

Virge::Stork is a library to help with PHP Based WebSockets, offering an abstraction above Ratchet to provide easy of implementation, horizontally scalable services, and per-topic subscription authentication

  Sources   Download

MIT

The Requires

 

by Michael Kramer

23/09 2017

v2.8.0

2.8.0.0

Virge::Stork is a library to help with PHP Based WebSockets, offering an abstraction above Ratchet to provide easy of implementation, horizontally scalable services, and per-topic subscription authentication

  Sources   Download

MIT

The Requires

 

by Michael Kramer

28/07 2017

v2.x-dev

2.9999999.9999999.9999999-dev

Virge::Stork is a library to help with PHP Based WebSockets, offering an abstraction above Ratchet to provide easy of implementation, horizontally scalable services, and per-topic subscription authentication

  Sources   Download

MIT

The Requires

 

The Development Requires

by Michael Kramer

28/07 2017

v2.5.6

2.5.6.0

Virge::Stork is a library to help with PHP Based WebSockets, offering an abstraction above Ratchet to provide easy of implementation, horizontally scalable services, and per-topic subscription authentication

  Sources   Download

MIT

The Requires

 

by Michael Kramer

28/07 2017

v2.5.5

2.5.5.0

Virge::Stork is a library to help with PHP Based WebSockets, offering an abstraction above Ratchet to provide easy of implementation, horizontally scalable services, and per-topic subscription authentication

  Sources   Download

MIT

The Requires

 

by Michael Kramer

26/07 2017

v2.5.4

2.5.4.0

Virge::Stork is a library to help with PHP Based WebSockets, offering an abstraction above Ratchet to provide easy of implementation, horizontally scalable services, and per-topic subscription authentication

  Sources   Download

MIT

The Requires

 

by Michael Kramer

18/07 2017

v2.5.2

2.5.2.0

Virge::Stork is a library to help with PHP Based WebSockets, offering an abstraction above Ratchet to provide easy of implementation, horizontally scalable services, and per-topic subscription authentication

  Sources   Download

MIT

The Requires

 

by Michael Kramer

14/06 2017

v2.5.0

2.5.0.0

Virge::Stork is a library to help with PHP Based WebSockets, offering an abstraction above Ratchet to provide easy of implementation, horizontally scalable services, and per-topic subscription authentication

  Sources   Download

MIT

The Requires

 

by Michael Kramer

11/04 2017

v2.2.0

2.2.0.0

Virge::Stork is a library to help with PHP Based WebSockets, offering an abstraction above Ratchet to provide easy of implementation, horizontally scalable services, and per-topic subscription authentication

  Sources   Download

MIT

The Requires

 

by Michael Kramer

17/03 2017

v2.1.8

2.1.8.0

Virge::Stork is a library to help with PHP Based WebSockets, offering an abstraction above Ratchet to provide easy of implementation, horizontally scalable services, and per-topic subscription authentication

  Sources   Download

MIT

The Requires

 

The Development Requires

by Michael Kramer

09/03 2017

v2.1.4

2.1.4.0

Virge::Stork is a library to help with PHP Based WebSockets, offering an abstraction above Ratchet to provide easy of implementation, horizontally scalable services, and per-topic subscription authentication

  Sources   Download

MIT

The Requires

 

The Development Requires

by Michael Kramer

09/03 2017

v2.1.6

2.1.6.0

Virge::Stork is a library to help with PHP Based WebSockets, offering an abstraction above Ratchet to provide easy of implementation, horizontally scalable services, and per-topic subscription authentication

  Sources   Download

MIT

The Requires

 

The Development Requires

by Michael Kramer

09/03 2017

v2.1.3

2.1.3.0

Virge::Stork is a library to help with PHP Based WebSockets, offering an abstraction above Ratchet to provide easy of implementation, horizontally scalable services, and per-topic subscription authentication

  Sources   Download

MIT

The Requires

 

The Development Requires

by Michael Kramer

09/03 2017

v2.1.2

2.1.2.0

Virge::Stork is a library to help with PHP Based WebSockets, offering an abstraction above Ratchet to provide easy of implementation, horizontally scalable services, and per-topic subscription authentication

  Sources   Download

MIT

The Requires

 

The Development Requires

by Michael Kramer

14/12 2016

v2.1.1

2.1.1.0

Virge::Stork is a library to help with PHP Based WebSockets, offering an abstraction above Ratchet to provide easy of implementation, horizontally scalable services, and per-topic subscription authentication

  Sources   Download

MIT

The Requires

 

The Development Requires

by Michael Kramer

12/12 2016

v2.0.8

2.0.8.0

Virge::Stork is a library to help with PHP Based WebSockets, offering an abstraction above Ratchet to provide easy of implementation, horizontally scalable services, and per-topic subscription authentication

  Sources   Download

MIT

The Requires

 

The Development Requires

by Michael Kramer

09/12 2016

v2.0.7

2.0.7.0

Virge::Stork is a library to help with PHP Based WebSockets, offering an abstraction above Ratchet to provide easy of implementation, horizontally scalable services, and per-topic subscription authentication

  Sources   Download

MIT

The Requires

 

The Development Requires

by Michael Kramer

09/12 2016

v2.0.6

2.0.6.0

Virge::Stork is a library to help with PHP Based WebSockets, offering an abstraction above Ratchet to provide easy of implementation, horizontally scalable services, and per-topic subscription authentication

  Sources   Download

MIT

The Requires

 

The Development Requires

by Michael Kramer

08/12 2016

v2.0.5

2.0.5.0

Virge::Stork is a library to help with PHP Based WebSockets, offering an abstraction above Ratchet to provide easy of implementation, horizontally scalable services, and per-topic subscription authentication

  Sources   Download

MIT

The Requires

 

The Development Requires

by Michael Kramer

08/12 2016

v2.0.4

2.0.4.0

Virge::Stork is a library to help with PHP Based WebSockets, offering an abstraction above Ratchet to provide easy of implementation, horizontally scalable services, and per-topic subscription authentication

  Sources   Download

MIT

The Requires

 

The Development Requires

by Michael Kramer

08/12 2016

v2.0.3

2.0.3.0

Virge::Stork is a library to help with PHP Based WebSockets, offering an abstraction above Ratchet to provide easy of implementation, horizontally scalable services, and per-topic subscription authentication

  Sources   Download

MIT

The Requires

 

The Development Requires

by Michael Kramer

08/12 2016

v2.0.2

2.0.2.0

Virge::Stork is a library to help with PHP Based WebSockets, offering an abstraction above Ratchet to provide easy of implementation, horizontally scalable services, and per-topic subscription authentication

  Sources   Download

MIT

The Requires

 

The Development Requires

by Michael Kramer

08/12 2016

v2.0.1

2.0.1.0

Virge::Stork is a library to help with PHP Based WebSockets, offering an abstraction above Ratchet to provide easy of implementation, horizontally scalable services, and per-topic subscription authentication

  Sources   Download

MIT

The Requires

 

The Development Requires

by Michael Kramer

04/04 2016

v2.1.0

2.1.0.0

Virge::Stork is a library to help with PHP Based WebSockets, offering an abstraction above Ratchet to provide easy of implementation, horizontally scalable services, and per-topic subscription authentication

  Sources   Download

MIT

The Requires

 

The Development Requires

by Michael Kramer

04/04 2016

v2.1.5

2.1.5.0

Virge::Stork is a library to help with PHP Based WebSockets, offering an abstraction above Ratchet to provide easy of implementation, horizontally scalable services, and per-topic subscription authentication

  Sources   Download

MIT

The Requires

 

The Development Requires

by Michael Kramer

04/04 2016

v2.1.7

2.1.7.0

Virge::Stork is a library to help with PHP Based WebSockets, offering an abstraction above Ratchet to provide easy of implementation, horizontally scalable services, and per-topic subscription authentication

  Sources   Download

MIT

The Requires

 

The Development Requires

by Michael Kramer

04/04 2016

v2.5.1

2.5.1.0

Virge::Stork is a library to help with PHP Based WebSockets, offering an abstraction above Ratchet to provide easy of implementation, horizontally scalable services, and per-topic subscription authentication

  Sources   Download

MIT

The Requires

 

The Development Requires

by Michael Kramer

04/04 2016

v2.5.3

2.5.3.0

Virge::Stork is a library to help with PHP Based WebSockets, offering an abstraction above Ratchet to provide easy of implementation, horizontally scalable services, and per-topic subscription authentication

  Sources   Download

MIT

The Requires

 

The Development Requires

by Michael Kramer