Defer
Interfaces
This interface MUST be implemented by any class that reports exceptions from deferred callbacks.
Classes
This class MUST be used to manage deferred callbacks that SHALL be executed at the end of a scope.
Aggregates multiple error reporters and delegates error reporting to all of them.
This error reporter implementation MUST log all reported exceptions using error_log.
This error reporter implementation MUST dispatch all reported exceptions as events using a PSR-14 compatible event dispatcher.
This error reporter implementation MUST log all reported exceptions using a PSR-3 compatible logger.
Listener that logs failed deferred callback executions using a PSR-3 compatible logger.
This provider MUST be used to supply listeners for DeferredCallbackFailed events.
This middleware MUST be used to inject and manage a Defer instance in a PSR-15 ServerRequest.
This utility class MUST be used to generate human-readable descriptions for any PHP callable.
Functions
Creates a new Defer instance, optionally registering a callback immediately.
Executes a callback within a controlled scope, ensuring resources are released at the end.
Executes a callback within a deferred scope, ensuring all registered callbacks are executed at the end.
Creates a new Defer instance, optionally registering a callback immediately.
defer([
callable|null
$callback = null],
mixed
...$arguments) : DeferInterface
Description
This function MUST return a DeferInterface implementation. If a callback is provided, it SHALL be registered.
Parameters
$callback
:
callable|null
=
null
Description
the callback to register (optional)
$arguments
:
mixed
Description
Arguments for the callback.
Return values
Description
the Defer instance
Executes a callback within a controlled scope, ensuring resources are released at the end.
using(
callable
$factory,
callable
$callback) : mixed
Description
This function MUST create a Defer instance, pass it to the factory, and execute the callback. The Defer instance SHALL be unset after execution.
Parameters
$factory
:
callable
Description
a function that receives the Defer and returns the resource
$callback
:
callable
Description
a function that receives the resource and executes the desired logic
Return values
Description
the return value of the callback
Executes a callback within a deferred scope, ensuring all registered callbacks are executed at the end.
scope(
callable
$callback) : mixed
Description
This function MUST create a Defer instance, pass it to the callback, and unset it after execution.
Parameters
$callback
:
callable
Description
a function that receives the Defer and executes the desired logic
Return values
Description
the return value of the callback