dhii/event-dispatcher-interface

Standard interfaces for event handling.

Maintainers

Details

github.com/Dhii/event-dispatcher-interface

Source

Installs: 20 740

Dependents: 1

Suggesters: 1

Security: 0

Stars: 0

Watchers: 1

Forks: 24

v0.2.0-alpha1 2021-06-01 16:47 UTC

Requires

Requires (Dev)

MIT 0158c111a484081ebbcc740048f86a73ff66690c

  • PHP-FIG
  • Anton Ukhanev <xedin.unknown.woop@gmail.com>

eventspsrpsr-14

This package is auto-updated.

Last update: 2024-11-29 06:10:01 UTC

README

Continuous Integration Latest Stable Version Latest Unstable Version

Enhancements to PSR-14.

Details

This is a fork of the original event-dispatcher PSR package. The aim was to make it compatible with PHP 7.0, but now this package has evolved and is instead aimed to enhance the interfaces of PSR-14, which this package is fully compatible with.

Enhancements

The following interfaces extend the existing PSR-14 spec in order to provide interop for working with name-based events, e.g. in event models where an event is identified by its name rather than class, such as in WordPress.

  • AddListenerCapableInterface allows adding a listener to an event identified by name, with priority.
  • RemoveListenerCapableInterface allows removing a listener by name and priority.

Shadows

The interfaces that simply shadow PSR-14 interfaces without changing anything are deprecated, namely:

  • EventDispatcherInterface;
  • IsPropagationStoppedCapableInterface;
  • ListenerProviderInterface.

These will likely be removed in a future version, because they are redundant due to the new PHP 7.2 requirement allowing all the features of PSR-14. They are kept here in order to avoid breaking dependants that use them.