ioc-interop/impl

Reference implementations of Ioc-Interop.

1.x-dev 2026-07-08 22:15 UTC

Requires

• php: >=8.4
• ioc-interop/interface: 1.x@dev

Requires (Dev)

• pds/composer-script-names: ^1.0
• pds/skeleton: ^1.0
• phpstan/phpstan: ^2.0
• phpunit/phpunit: ^11.0
• pmjones/php-styler: 0.x@dev

MIT

• Paul M. Jones

Published on Packagist.org on 2026-07-08 22:15 UTC

README

Reference implementations of the Ioc-Interop interfaces for PHP 8.4+.

Installation

composer require ioc-interop/impl

Usage

Compose a container by populating a IocContainerFactory with shared instances and service factories, then ask it for a new container:

use IocInterop\Impl\ContainerFactory;
use IocInterop\Interface\IocContainer;

$containerFactory = new ContainerFactory();

$containerFactory->instances = [
    PDO::class => new PDO('sqlite::memory:'),
];

$containerFactory->factories = [
    Logger::class => fn (IocContainer $ioc) => new Logger(),
    UserService::class => fn (IocContainer $ioc) => new UserService(
        $ioc->getService(PDO::class),
        $ioc->getService(Logger::class),
    ),
];

$ioc = $containerFactory->newContainer();

Retrieve services by name. The first call to getService() resolves and shares the instance for subsequent calls:

$logger = $ioc->getService(Logger::class);
$users = $ioc->getService(UserService::class);

Check for service availability:

if ($ioc->hasService(Logger::class)) {
    // ...
}

Requesting a service that is not registered throws a ContainerException:

use IocInterop\Interface\IocThrowable;

try {
    $ioc->getService('does-not-exist');
} catch (IocThrowable $e) {
    // ...
}

Classes

Interface	Implementation
IocContainer	Container
IocContainerFactory	ContainerFactory
IocThrowable	ContainerException

All classes are in the IocInterop\Impl namespace.

See the Ioc-Interop interface package for the full specification.