sportlog/di

A simple PSR-11 dependency injection container

v1.2.0 2023-11-11 12:06 UTC

Requires

• php: >=8.0
• psr/container: ^2.0

Requires (Dev)

• phpstan/phpstan: ^1.7
• phpunit/phpunit: ^10.4

MIT

• Johannes Aberidis

• dependency injection
• container
• di
• PSR-11

README

A simple PSR-11 dependency injection container.

Install via Composer

You can install sportlog/di using Composer.

$ composer require sportlog/di

Minimum PHP version required is 8.

How to use

<?php

require 'vendor/autoload.php';

use Sportlog\DI\Container;

// Given this class and interface:
interface FooInterface
{
    public function getFoo(): string;
}

class Foo implements FooInterface
{
    public function __construct(private ?string $foo = 'foo')
    {
    }

    public function getFoo(): string
    {
        return $this->foo;
    }
}

// 1) You can simply get the instance via class id
$container = new Container();
$foo = $container->get(Foo::class);
echo $foo->getFoo();    // outputs: "foo"

// 2) When working with interfaces you must set
// the class id which shall be created
$container = new Container();
$container->set(FooInterface::class, Foo::class);
$foo = $container->get(FooInterface::class);
echo $foo->getFoo();    // outputs: "foo"

// 3) You can also use a factory. Parameters are
// getting injected
class Config
{
    public function getFooInit(): string
    {
        return 'init-foo';
    }
}

$container = new Container();
// Instance of Config will be injected to the factory
$container->set(
    FooInterface::class,
    fn (Config $config) => new Foo($config->getFooInit())
);
$foo = $container->get(FooInterface::class);
echo $foo->getFoo();    // outputs: "init-foo"