Download the PHP package ptrofimov/zeroevents without Composer
On this page you can find all versions of the php package ptrofimov/zeroevents. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
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 zeroevents
zeroevents
Events between processes. Built on top of Illuminate\Events and ZeroMQ.
It could be used for building distributed PHP applications and asynchronous event processing systems with ZeroMQ as transport for messages.
Installation
Install package using composer
Quick Introduction
-
- In the first process: subscribe EventListener to desired events.
In EventListener constructor could be passed either array of options (will be merged with default options) or string (path to options for Config::get())
-
- In the second process: define listeners for events. And run event service that will listen to messages on socket and fire incoming events.
That's it. Each time the event is fired in first process, that will be transferred to the second process and be fired there as well.
EventSocket class
EventSocket PHP class is inherited from ZMQSocket. Its supports all native methods like connect and send, plus it adds methods for sending and receiving events with ZeroMQ.
Methods
- encode(string event, array payload) - serialize event and payload into array of frames before sending
- event goes as string in the first frame of message
- payload is serialized in JSON(by default) and goes in the following frames of message
- encode method is used in push method
- decode(array frames) - unserialize event and payload from array of frames after receiving
- return array [event, payload]
- event is supposed to go as string in the first frame of message
- payload is supposed to go as serialized in JSON in the following frames of message
- decode method is used in pull method
Connecting socket
You can use usual way to connect to ZeroMQ socket via calling the constructor of ZMQSocket or, better, use EventListener that gives you connected socket on the base of options from config.
Pushing events
It is recommended to listen to events that occur during sending of the message (ttl expired, out of connection) to handle them.
EventListener class
EventListener PHP class is supposed to be passed to event dispatcher as listener callback. It has magic method __invoke, that is called, when an event is fired. EventListener creates EventSocket instance on-demand (lazy connection) and call method EventSocket::push.
Constructor accepts either string (config key) or array of options.
Connection options
EventService class
Class is used to listen to incoming events and fire them.
Polling sockets
EventService class is able to listen to several sockets the same time.
Idle events
You can specify the polling time - max time that service waits for incoming events and if there are no such events, it fires zeroevents.service.idle event, which you can handle and execute your own code while there is no work for the service.
System signals
EventService class has default handler for system POSIX signals. It ignores SIGHUP, and gracefully stops on SIGTERM and SIGINT signals. Sure, you could define your own system signal handler.
Stopping the service
Normally, the service is being stopped by system signal. But you could easily stop the service by firing zeroevents.service.stop event.
License
Copyright (c) 2015 Petr Trofimov
MIT License
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
