Skip to content

prooph/psb-http-producer

Repository files navigation

Guzzle HTTP message dispatcher for ProophServiceBus

Build Status Coverage Status Gitter

Use php-http/httplug as message producer for Prooph Service Bus. Works together with all bus types: CommandBus, EventBus and QueryBus.

Important

This library will receive support until December 31, 2019 and will then be deprecated.

For further information see the official announcement here: https://www.sasaprolic.com/2018/08/the-future-of-prooph-components.html

Installation

You can install the producer via composer by adding "prooph/psb-http-producer": "^1.0" as requirement to your composer.json.

Usage

Pass a ready-to-use Http\Client\HttpClient to Prooph\ServiceBus\Message\Http\HttpMessageProducer together with a Prooph\Common\Messaging\MessageConverter.

For async requests use an Http\Client\HttpAsyncClient with \Prooph\ServiceBus\Message\Http\HttpAsyncMessageProducer.

The MessageProducer sends a POST request to an endpoint specified by a psr-7 URI (using psr/http-message) with the json encoded message as body.

An async request means that when the producer is used for querying remote services (QueryBus) the producer does not wait until the promise gets resolved.

For an overview of all ready-to-use http client implementations, check the official documentation of php-http.

Support

Contribute

Please feel free to fork and extend existing or add new features and send a pull request with your changes! To establish a consistent code quality, please provide unit tests for all your changes and may adapt the documentation.

License

Released under the New BSD License.