Extending Existing Services

PHP-DI allows us to extend services that were defined previously, for example in another sprinkle, using decorators.

Most of the default services that UserFrosting defines can be overridden in your sprinkle. However, some higher level services cannot be extended since they have already been invoked before the SprinkleManager can load the sprinkles. These services are mostly in the UserFrosting Framework.

Overriding Existing Services

Extending a service is done using the same callback used to register one, except said callback is registered with the \DI\decorate method (instead of a factory or other technique).

For example, if you want to extend the ExceptionHandlerMiddleware service to register a new handler :

public function register(): array
{
    return [
        ExceptionHandlerMiddleware::class => \DI\decorate(function (ExceptionHandlerMiddleware $middleware, ContainerInterface $c) {
            $middleware->registerHandler(LoggedInException::class, LoggedInExceptionHandler::class);

            return $middleware;
        }),
    ];
}

The first parameter of the callable is the instance returned by the previous definition (i.e. the one we wish to decorate), the second parameter is the container.