Download the PHP package phpgears/event without Composer
On this page you can find all versions of the php package phpgears/event. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download phpgears/event
More information about phpgears/event
Files in phpgears/event
Package event
Short Description Event handling
License MIT
Homepage https://github.com/phpgears/event
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 event
Event
Event base classes and handling interfaces
This package only provides the building blocks to events
Installation
Composer
Usage
Require composer autoload file
Events
Events are DTOs that carry all the information of an already happened situation
You can create your own by implementing Gears\Event\Event or extending from Gears\Event\AbstractEvent which ensures event immutability and payload and metadata is composed only of scalar values which is a very interesting capability. AbstractEvent has a private constructor forcing you to create events using occurred static method on your named constructors
In case of a event without any payload you could extend Gears\Event\AbstractEmptyEvent
Collection
Events can be grouped into iterables implementing Gears\Event\EventCollection objects, Gears\Event\EventArrayCollection and Gears\Event\EventIteratorCollection are provided accepting only instances of Gears\Event\Event
Async events
Having event assuring all of its payload is composed only of scalar values proves handy when you want to delegate event handling to a message queue system such as RabbitMQ, Gearman or Apache Kafka, serializing/deserializing scalar values is trivial in any format and language
Asynchronous behaviour must be implemented at EventBus level, event bus must be able to identify async events (a map of events, implementing an interface, by a payload parameter, ...) and enqueue them
If you want to have asynchronous behaviour on your EventBus have a look phpgears/event-async, there you'll find all the necessary pieces to start your async event bus
Handlers
Events are handed over to implementations of Gears\Event\EventHandler, available in this package is AbstractEventHandler which verifies the type of the event so you can focus only on implementing the handling logic
Have a look at phpgears/dto fo a better understanding of how events are built out of DTOs and how they hold their payload
Event Bus
Only Gears\Event\EventBus interface is provided, you can easily use any of the good bus libraries available out there by simply adding an adapter layer
Implementations
Event bus implementations currently available
- phpgears/event-symfony-messenger uses Symfony's Messenger
- phpgears/event-symfony-event-dispatcher uses Symfony's Event Dispatcher
Contributing
Found a bug or have a feature request? Please open a new issue. Have a look at existing issues before.
See file CONTRIBUTING.md
License
See file LICENSE included with the source code for a copy of the license terms.
