celemas/container

A PSR-11 compatible dependency injection library

0.4.0 2026-05-12 17:47 UTC

Requires

• php: ^8.5
• celemas/wire: ^0.6.0
• psr/container: ^2.0

Requires (Dev)

• celemas/dev: ^4.1

MIT

• Ernst

• dependency injection
• container
• di
• ioc
• PSR-11
• psr11

README

A PSR-11 compatible dependency injection container.

Entry lifetimes

Container entries use explicit lifetimes:

• shared() caches one instance per container (default for added entries)
• scoped() caches one instance per requesting container scope
• transient() never caches
• value() returns the configured definition as-is (for literals or raw closures)

$container->add('config', ['debug' => true])->value();
$container->add(Service::class)->shared();
$container->add(RequestContext::class)->scoped();
$container->add(Builder::class)->transient();

Scope mode

Use scope() to create an isolated container for one unit of work:

$root = new Container();
$root->add('app-name', 'celemas')->value();
$root->add('global-service', GlobalService::class)->shared();
$root->add('request-service', RequestService::class)->scoped();

$scope = $root->scope();
$scope->add(Request::class, $request)->value();

// ... resolve request-local services
$scope->reset();

After the first scope() call, the root container is sealed and no longer accepts structural mutations. Scope tags can inherit pre-defined root tags while keeping their own local caches.

Services that should be cleaned between scopes can implement Celemas\Container\Resettable and will be reset during $scope->reset().

License

This project is licensed under the MIT license.