Download the PHP package cmosguy/laravel-http-pushstream-broadcaster without Composer

On this page you can find all versions of the php package cmosguy/laravel-http-pushstream-broadcaster. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package laravel-http-pushstream-broadcaster

HTTP Push-Stream Nginx Module Laravel Broadcast Driver

Thank your for your interest in the HTTP Push-stream Nginx broadcast driver for Laravel. If you are here, it is because you are trying to leverage the latest feature within the Laravel 5.1 broadcasts events for websockets. The HTTP Pushstream Module for Nginx is a powerful Websocket system.

Why use HTTP Pushstream?

If you want to really absorb the power of the capabilities of this module then check out what the dev-ops from Disqus thought in this link:

http://highscalability.com/blog/2014/4/28/how-disqus-went-realtime-with-165k-messages-per-second-and-l.html

How does this driver work?

Once you setup all your routes for the pub/sub requests to the HTTP routes in the location directives for Nginx, then you'll be able to quickly open a socket on your client use the pushstream.js and push your broadcasts out using websocket or long-polling.

The pub/sub requests are internally called by the GuzzleHttp package. The broadcasting.php config file will use the pushstream driver where you can control the HTTP requests to the to your pub/sub endpoints.

You can lock down your pub/sub nginx endpoints using the Access Key Module. Here you can configure the key.

Requirements

Installation

  1. Do a composer require get this package: composer require cmosguy/laravel-http-pushstream-broadcaster

  2. Next, go into your config/broadcasting.php file and add the following lines accordingly. base_url refers to websocket root for your HTTP requests pub/sub routes:

    'default' => 'pushstream',
    
    'pushstream' => [
        'driver' => 'pushstream',
        'base_url' => 'http://localhost',
        'access_key' => md5('foo'),
        'cert' => null
        // or 'cert' => 'path/to/server.crt' for self-signed certificate
    ]
  3. In your config/app.php add the following line to your providers array:

    'Cmosguy\Broadcasting\PushStreamBroadcastManagerProvider'

Sample Nginx Configuration

  1. In your /etc/nginx/nginx.conf file add:

    push_stream_shared_memory_size 32M;
  2. Edit your config file for your routes in the server { section. Obviously, you need to understand and modify the items below. The following config information is just meant to get you started. If you want a more thorough config check out this:

    location /channels-stats {
        # activate channels statistics mode for this location
        push_stream_channels_statistics;
    
        # query string based channel id
        push_stream_channels_path               $arg_id;
    }
    
    location /pub {
       # activate publisher (admin) mode for this location
       push_stream_publisher admin;
    
        # query string based channel id
        push_stream_channels_path               $arg_id;
    }
    
    location ~ /sub/(.*) {
        # activate subscriber (streaming) mode for this location
        push_stream_subscriber;
    
        # positional channel path
        push_stream_channels_path                   $1;
    }
    
    location ~ /ws/(.*) {
        # activate websocket mode for this location
        push_stream_subscriber websocket;
    
        # positional channel path
        push_stream_channels_path                   $1;
        if ($arg_tests = "on") {
          push_stream_channels_path                 "test_$1";
        }
    
        # store messages in memory
        push_stream_store_messages              on;
    
        push_stream_websocket_allow_publish     on;
    
        if ($arg_qs = "on") {
          push_stream_last_received_message_time "$arg_time";
          push_stream_last_received_message_tag  "$arg_tag";
          push_stream_last_event_id              "$arg_eventid";
        }
    }

Locking down the pub/sub endpoint

    location /pub {
       # activate publisher (admin) mode for this location
       push_stream_publisher admin;
       accesskey                on;
       accesskey_hashmethod     md5;
       accesskey_arg            "access_key";
       accesskey_signature      "foo"

        # query string based channel id
        push_stream_channels_path               $arg_id;
    }

Usage in your app

So, once you are finally ready to trigger an event, you can do this easily now by just extending this broadcastOn in your event handler:

The Client

Please download the pushstream.js from either following locations:

Study the Push Stream Module

At this time the only way to get more information from about the module and the capabilities is directly from the github repository, so do some reading here:

Disclaimer

This is by no means the only way to go about how this should work. You need to understand what all the options do and there is definitely a a

Help

Please help me with updating this documentation. If it does not make sense or if you see something stupid let me know. Also, if there is a way to make this extend further and make it more flexible for others, please submit a PR to improve upon these.


All versions of laravel-http-pushstream-broadcaster with dependencies

PHP Build Version
Package Version
Requires php Version >=5.3.1
guzzlehttp/guzzle Version ~5.3
illuminate/support Version ~5.1
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package cmosguy/laravel-http-pushstream-broadcaster contains the following files

Loading the files please wait ....