***

# 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`](./ContainerInterface.md)
* This class is a **Final class**




## Methods


### __construct

Constructs a new ServiceProviderContainer instance.

```php
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.

```php
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.

```php
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:**
<p>if no factory exists for the given identifier</p>

- [`NotFoundException`](./Exception/NotFoundException.md)
<p>if service construction fails due to container errors</p>

- [`ContainerException`](./Exception/ContainerException.md)



***


***
> Automatically generated on 2025-07-03