Search by

entire-studio / dependency-injection

Gormack

PSR-11 compatible dependency injection container

Package info

github.com/entire-studio/dependency-injection

pkg:composer/entire-studio/dependency-injection

Statistics

Installs: 102

Dependents: 0

Suggesters: 0

Stars: 1

Open Issues: 0

v1.3.0 2026-10-19 15:16 UTC

This package is auto-updated.

Last update: 2026-11-03 10:45:21 UTC


README

Packagist Version (including pre-releases) GitHub release (latest SemVer including pre-releases) PHP CI codecov

PSR-11 compatible dependency injection container. Requires PHP 8.2+.

Contents

Installation

Install the latest version with

$ composer require entire-studio/dependency-injection

Basic Usage

<?php

declare(strict_types=1);

require_once __DIR__ . '/vendor/autoload.php';

use EntireStudio\DependencyInjection\Container;

interface Logger
{
    public function log(string $message): void;
}

class StdoutLogger implements Logger
{
    public function log(string $message): void
    {
        echo '[log] ' . $message . PHP_EOL;
    }
}

class UserRepository
{
    public function __construct(public readonly Logger $logger) {}
}

$di = new Container();
$di->set(Logger::class, StdoutLogger::class);

// UserRepository's only dep is autowired from the binding above
$repo = $di->get(UserRepository::class);
$repo->logger->log('ready');

Other examples

The examples/ directory has runnable scripts covering every feature:

File Covers
01_autowiring.php Interface binding + recursive constructor autowiring
02_lifecycle.php set() singleton vs factory() per-call vs value() literal; unset() / clear()
03_closures.php Closure bindings for primitives and runtime config
04_tagged_services.php tag() / untag() / getTagged() for plugin/listener groups
05_decorators.php extend() for stacked decorators
06_method_injection.php injectMethod() for setter injection
07_invoking_callables.php call() for autowired handler/action dispatch
08_inject_attribute.php #[Inject(id)] attribute to override per-parameter resolution

Run any of them with php examples/<file>.php.

PSR-11

The container implements Psr\Container\ContainerInterface (psr/container ^2.0).

  • get(string $id): mixed — returns the entry. Throws NotFoundExceptionInterface when no entry exists for $id (and $id isn't an instantiable class), or ContainerExceptionInterface for any other failure during construction.
  • has(string $id): bool — returns true only for ids previously registered via set() / factory(). Per the spec, has() === false does not preclude get() from succeeding (autowiring may still resolve it), and has() === true does not guarantee get() will not throw.

The container self-registers under Psr\Container\ContainerInterface and its own concrete class — get(ContainerInterface::class) and get(Container::class) both return $this, and constructor parameters of either type are auto-wired to the active container.

Lifecycle

By default, the container caches resolved instances — subsequent get($id) calls return the same object (singleton-by-default).

To get a fresh instance on every get(), register a factory:

$di->factory(Clock::class, fn() => new SystemClock());
$a = $di->get(Clock::class);
$b = $di->get(Clock::class);
// $a !== $b

To register a literal value (config string, array, pre-built object), use value():

$di->value('db.dsn', 'sqlite::memory:');
$di->get('db.dsn'); // 'sqlite::memory:'

Re-registering with set(), factory(), or value() clears any cached state for that id.

unset($id) drops a single binding (entry + cached instance + factory marker), and clear() resets all user state; the container's self-registration is preserved.

Aliases and sharing

Singleton caching is keyed on the requested id, not the resolved target. Two aliases pointing at the same concrete class produce two distinct instances:

$di->set(LoggerA::class, FileLogger::class);
$di->set(LoggerB::class, FileLogger::class);
$di->get(LoggerA::class); // FileLogger instance #1
$di->get(LoggerB::class); // FileLogger instance #2 — not shared

To share a single instance across aliases, register the concrete first and have the aliases delegate to it via a Closure:

$di->set(LoggerA::class, fn(Container $c) => $c->get(FileLogger::class));
$di->set(LoggerB::class, fn(Container $c) => $c->get(FileLogger::class));
// both now resolve to the same FileLogger singleton

Commands

Development

  • composer test - runs test suite.
  • composer sat - runs static analysis.
  • composer style - checks codebase against PSR-12 coding style.
  • composer style:fix - fixes basic coding style issues.
  • composer mutation - runs Infection mutation tests (MSI ≥ 85% / Covered MSI ≥ 90%).

Changelog

See CHANGELOG.md for release history.