Pushman

Pushman is an open source web socket event manager. It allows you to push events over HTTP to your own Pushman server which will push event information down to a client via a Web Socket.

You can bind server side events to client notifications.

Demo on the Pushman Website.

Todo for Version 3

Okay, testing is the next big thing. Thanks to laravel 5.1, I'll write up tests in PHPUnit!

• ~~Rewrite PushmanHandler -> Use Non-queued job instead of a class~~
• ~~General code cleanup (lots of mess around)~~
• Make API endpoint for broadcasting to a specific client only.
• Write for Pushman :) Integrate with travis-ci
• Way better documentation for building your own Pushman.
  • Implement Swagger.io? Easy clean docs for the API.
• Allow users to broadcast back to the server?

Long term todo list

• Shad is working on a cool new User Interface
• Build Pushman Lite as an independant Package to include in single sites.
• Push console logs out on PushmanInternal Channel.

Official Documentation

Documentation for usage can be found on the Pushman website.

Documentation for building your own Pushman instance is found below.

Building your own Pushman Instance

Pushman works fantastically on Laravel's Forge! You still need to install prerequisites though.

PHP Extensions

Pushman requires ZeroMQ which is a custom binary (Windows and Linux), along with it's PHP extension.

You can follow zmq's installation instructions, but you should know building it for a Forge server is easy.

Step 1 - Install the Binary

When installing on Windows, you can just install the .exe from their website.

For Debian based systems, there is an apt package:

apt-get install libzmq3-dev

ZeroMQ Download

Step 2 - Install the PHP Extension

You can always build the PHP extension yourself:

git clone git://github.com/mkoppanen/php-zmq.git
$ cd php-zmq
phpize && ./configure
$ sudo make
$ sudo make install

extension=zmq.dll

PHP Extension Download

Port Requirements

Pushman requires two ports to function, an

INTERNAL

PUBLIC

By default both of these ports are configurable in the

.env

PUBLIC

.env file:

PUSHMAN_PORT=8080
PUSHMAN_INTERNAL=5555

Installing the Code

On forge, you can just build a new site, and give the it the Github repo to install itself.

Duffleman/pushman

On a regular server, git clone the directory and run

composer install --no-dev

Configuration

Pushman requires a database, so for both Forge and a regular server, enter your Database editor of choice, or sqlite, and build a database and enter the details in the

.env

Once the database configuration is set, you can run

php artisan migrate

php artisan key:generate

You MUST set an App Key.

You may also need to run

chmod -R 777 storage/

chmod -R 777 bootstrap/cache

Runtime

Pushman itself can then be run by using

php artisan pushman:run

Example Command

php /home/forge/pushman.dfl.mn/artisan pushman:run

Security Vulnerabilities

If you discover a security vulnerability within Pushman, please send an e-mail to George Miller at [email protected] All security vulnerabilities will be promptly addressed.

License

Pushman is open-sourced software licensed under the MIT license

Thinking out load

Payload Pushing

Currently we use a TOKEN in the URL string to see if the user is authorized to connect. Could we find a better way to push data to the server, things like a unique ID identifying them as a user perhaps?

After that, we can allow an API to /api/listeners or something which returns the listeners of a channel, the events they listen to, and any of that data. Then we allow an API point for /api/whisper which broadcasts back to a specific user only.