README

A minimal, explicit PSR-11 dependency injection container for PHP. No autowiring, no reflection, no annotations, no magic — what you register is exactly what you get.

Requirements & Installation

composer require wptechnix/di-container

• PHP 8.0+
• PSR-11 compliant (psr/container ^1.1 || ^2.0)

Quick Start

use WPTechnix\DI\Container;

$c = new Container();

// Register a singleton — factory runs once, instance is cached
$c->singleton('logger', fn() => new Logger());
$logger = $c->get('logger'); // same instance every time

// Register a factory — factory runs on every resolution
$c->factory('mail', fn() => new Mailer());
$mail1 = $c->get('mail'); // fresh instance
$mail2 = $c->get('mail'); // another fresh instance

The Three Resolver Forms

// Closure — full control, receives container + resolved params
$c->singleton('db', fn(Container $c) => new Connection($c->get('config')));

// String — class name, validated at registration time
$c->singleton('logger', Logger::class);

// Null — identifier IS the class name (shorthand)
$c->singleton(Logger::class);

Feature Overview

Learn More

For a guided tour, read the documentation in this order:

1. Singletons and Factories — the fundamental registration choice
2. Resolvers — the three ways to tell the container how to build a service
3. Constructor Parameters — passing values and service dependencies to constructors
4. Aliases — the interface-binding pattern
5. Tagged Services — grouping related services for bulk resolution
6. Extending Services — decorating services you don't own
7. Service Providers — modular bootstrapping with two-phase registration
8. Container Lifecycle — lazy initialization, resolution stack, boot freeze
9. Exceptions — when things go wrong (and how to prevent it)
10. API Reference — complete method signatures

License

MIT