Download the PHP package softonic/laravel-protobuf-events without Composer
On this page you can find all versions of the php package softonic/laravel-protobuf-events. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download softonic/laravel-protobuf-events
More information about softonic/laravel-protobuf-events
Files in softonic/laravel-protobuf-events
Package laravel-protobuf-events
Short Description Helper to allow nuwber/rabbitevents to work with protobuf
License Apache-2.0
Homepage https://github.com/softonic/laravel-protobuf-events
FAQ
Example:
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 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.
Informations about the package laravel-protobuf-events
Laravel Protobuf Events
Helper to allow nuwber/rabbitevents to work with protobuf
Main features
- Allow to publish/listen protobuf messages using nuwber/rabbit-events easily.
Installation
You can require the last version of the package using composer
Configuration
First you need to configure the nuwber/rabbit-events package to be able to use the package.
Then you must configure config/protobuf-events.php to set the client of the library. This client allows to isolate
different services, identifying the origin of the message.
Configuring a listener
In the RabbitEventsServiceProvider::boot() register the listeners that you want using the ExternalEvents::decorateListener() method.
The listener needs a method called handle() that will receive the message and the routing key,
and a method called setClient() to identify the origin of the message.
Publishing messages
To publish a message, you need to use the ExternalEvents::publish() method.
Advanced usage
Sometimes you need to use the package in a different way than the default. For example, you can use the package to decode
a message from a string. In that case, you are able to decode the message using the ExternalEvents::decode() method.
Logging protobuf messages
If you want to log the outgoing protobuf messages and the incoming ones, you can configure a logger and a formatter for the message to be logged.
For that purpose you have the methods ExternalEvents::setLogger() and ExternalEvents::setFormatter().
The logger must implement the Psr\Log\LoggerInterface and the formatter, the LogMessageFormatterInterface interface.
The formatter will have two methods, formatOutgoingMessage() and formatIncomingMessage(), that will be called when a message is sent or received, respectively.
Both should return a LogMessage object, which contains the message to log and the context.
The log level can be changed by setting the communications_log_level key in config/protobuf-events.php.
Testing
softonic/laravel-protobuf-events has a PHPUnit test suite, and a coding style compliance test suite using PHP CS Fixer.
To run the tests, run the following command from the project folder.
To open a terminal in the dev environment:
License
The Apache 2.0 license. Please see LICENSE for more information.
All versions of laravel-protobuf-events with dependencies
ext-protobuf Version *
ext-pcntl Version *
ext-bcmath Version *
ext-sockets Version *
google/protobuf Version ^3.19
nuwber/rabbitevents Version ^8.0