Download the PHP package superbalist/laravel4-pubsub without Composer

laravel4-pubsub

A Pub-Sub abstraction for Laravel 4.

This package is a wrapper bridging php-pubsub into Laravel 4.

For Laravel 5 support, use the package https://github.com/Superbalist/laravel-pubsub

The following adapters are supported:

• Local
• /dev/null
• Redis
• Kafka (see separate installation instructions below)
• Google Cloud
• HTTP

Installation

The package has a default configuration built-in.

To customize the configuration file, publish the package configuration using Artisan.

You can then edit the generated config at app/config/packages/superbalist/laravel4-pubsub/config.php.

Register the service provider in app.php

Register the facade in app.php

Kafka Adapter Installation

Please note that whilst the package is bundled with support for the php-pubsub-kafka adapter, the adapter is not included by default.

This is because the KafkaPubSubAdapter has an external dependency on the librdkafka c library and the php-rdkafka PECL extension.

If you plan on using this adapter, you will need to install these dependencies by following these installation instructions.

You can then include the adapter using:

Usage

Creating a Subscriber

A lot of pub-sub adapters will contain blocking subscribe() calls, so these commands are best run as daemons running as a supervisor process.

This is a sample subscriber written as an artisan command.

Kafka Subscribers

For subscribers which use the php-pubsub-kafka adapter, you'll likely want to change the consumer_group_id per subscriber.

To do this, you need to use the PubSubConnectionFactory to create a new connection per subscriber. This is because the consumer_group_id cannot be changed once a connection is created.

Here is an example of how you can do this:

Adding a Custom Driver

Please see the php-pubsub documentation Writing an Adapter.

To include your custom driver, you can call the extend() function.