All notable changes to this project will be documented in this file, in reverse chronological order by release.
- Nothing.
- Nothing.
- Nothing.
- Nothing.
- Nothing.
-
This version provides features to simplify using arbitrary services from your PSR-11 container, particularly services that might compose other dependencies. We recommend using these new features in almost every case, as they allow re-using services within your task workers regardless of the ability to serialize them. They include:
-
#4 adds the
DeferredServiceListener. It has a constructor that accepts a Swoole HTTP server, a listener for handling a task, and a service name by which that listener is pulled from a PSR-11 container. It also defines agetListener()method for retrieving the composed listener later. When invoked, it creates aServiceBasedTaskinstance with the service name and payload arguments. -
#4 adds the
ServiceBasedTaskclass, which implementsTaskInterface. When invoked, it pulls the composed service from the container instance passed to its invocation method; if that instance is aDeferredServiceListener, it re-assigns the instance to the results of calling thegetListener()method on that class. The service is then called to process the payload arguments. -
#4 adds the
DeferredServiceListenerDelegator. It creates aDeferredServiceListenerinstance composing the Swoole HTTP server instance, the listener produced by the$factoryargument, and the$serviceNamepassed to it. The class should be used as a delegator factory for any listener that is not directly serializable, including most services that compose other dependencies.
-
-
#4 changes the constructor of
TaskWorkerto now accept an initialPsr\Container\ContainerInterfaceargument. This change should be transparent to most users if they are using theConfigProvidershipped with the package. -
#4 changes the signature of
TaskInterface::invoke()to now require aPsr\Container\ContainerInterfaceargument.
- Nothing.
- Nothing.
- Nothing.
-
#1 adds the class
DeferredListener; it operates identically toQueuedListener, and replaces its functionality, albeit with a more accurate name. -
#2 adds the delegator factory
Phly\Swoole\TaskWorker\DeferredListenerDelegator. This factory can be attached to any listener service in order to allow it to be deferred when invoked. I suggest doing so inconfig/autoload/local.phpto allow testing the listener in development, but deferring it in production.
- Nothing.
- #1 deprecates the
QueueableListenerclass in favor of the newDeferredListenerclass.
- Nothing.
- Nothing.
- All functionality.
- Nothing.
- Nothing.
- Nothing.
- Nothing.