Skip to content

ServiceProviderContainer

Jump to bottom
Felipe Sayão Lobato Abreu edited this page Jul 3, 2025 · 2 revisions

ServiceProviderContainer

Implements a PSR-11 compliant dependency injection container using a container-interop/service-provider.

This container SHALL resolve services by delegating to the factories and extensions defined in the provided ServiceProviderInterface instance.

Services are lazily instantiated on first request and cached for subsequent retrieval, enforcing singleton-like behavior within the container scope.

The container supports service extension mechanisms by allowing callable extensions to modify or enhance services after construction, based on the service identifier or its concrete class name.

If an optional wrapper container is provided, it SHALL be passed to service factories and extensions, allowing for delegation or decoration of service resolution. If omitted, the container defaults to itself.

  • Full name: \FastForward\Container\ServiceProviderContainer
  • This class is marked as final and can't be subclassed
  • This class implements: \FastForward\Container\ContainerInterface
  • This class is a Final class

Properties

serviceProvider

The service provider supplying factories and extensions for service construction.

private \Interop\Container\ServiceProviderInterface $serviceProvider

wrapperContainer

The container instance used for service resolution and extension application.

private \Psr\Container\ContainerInterface $wrapperContainer

This property MAY reference another container for delegation, or default to this container instance.

cache

Cache of resolved services keyed by their identifier or class name.

private array<string,mixed> $cache

This array SHALL store already constructed services to enforce singleton-like behavior within the container scope.

Methods

__construct

Constructs a new ServiceProviderContainer instance.

public __construct(\Interop\Container\ServiceProviderInterface $serviceProvider, null|\Psr\Container\ContainerInterface $wrapperContainer = null): mixed

This constructor SHALL initialize the container with a service provider and an optional delegating container. If no wrapper container is provided, the container SHALL delegate to itself.

Parameters:

Parameter Type Description
$serviceProvider \Interop\Container\ServiceProviderInterface the service provider supplying factories and extensions
$wrapperContainer null|\Psr\Container\ContainerInterface An optional container for delegation. Defaults to self.

has

Determines if the container can return an entry for the given identifier.

public has(string $id): bool

This method MUST return true if the entry exists in the cache or factories, false otherwise.

Parameters:

Parameter Type Description
$id string identifier of the entry to look for

Return Value:

true if the entry exists, false otherwise

get

Retrieves a service from the container by its identifier.

public get(string $id): mixed

This method SHALL return a cached instance if available, otherwise it resolves the service using the factory provided by the service provider.

If the service has a corresponding extension, it SHALL be applied post-construction.

Parameters:

Parameter Type Description
$id string the identifier of the service to retrieve

Return Value:

the service instance associated with the identifier

Throws:

if no factory exists for the given identifier

if service construction fails due to container errors

applyServiceExtensions

Applies service extensions to the constructed service instance.

private applyServiceExtensions(string $id, string $class, mixed $service): void

This method SHALL inspect the set of extensions returned by the service provider, checking both the original service identifier and the concrete class name of the service instance. If a corresponding extension is found, it MUST be a callable and SHALL be invoked with the container and service instance as arguments.

Extensions MAY be used to modify or enhance services after creation. Invalid extensions (non-callables) SHALL be ignored silently.

Parameters:

Parameter Type Description
$id string the identifier of the resolved service
$class string the fully qualified class name of the service
$service mixed the service instance to apply extensions to

Throws:

if an extension callable fails during execution

Automatically generated on 2025-07-03

Clone this wiki locally