README

Minimalist and Modern Dependency Injection Container for PHP 8.3+

Kaly DI is a lightweight, flexible, and PSR-11 compliant dependency injection (DI) container designed for modern PHP applications. It emphasizes simplicity, performance, and clear code without reliance on attributes or "magic."

Key Features

PSR-11 Compliance: Seamlessly interoperable with PHP standards.
No Attributes, No Magic: Keep your code clean and decoupled from the container.
Strongly Typed Definitions: Define dependencies in PHP for full IDE support (autocompletion, refactoring).
Advanced Auto-wiring: Automatic dependency resolution, fine-tunable with resolvers.
Performance Focused: Minimal overhead, designed to be extremely fast.
Developer Friendly: Comprehensive error reporting and development-only assertions.

Installation

composer require lekoala/kaly-di

Quick Start

use Kaly\Di\Container;
use Kaly\Di\Definitions;

// 1. Define dependencies
$definitions = Definitions::create()
    ->set(\PDO::class, new \PDO('sqlite::memory:'));

// 2. Create the container
$container = new Container($definitions);

// 3. Get auto-wired instances
$myObject = $container->get(MyClass::class);

Documentation

Detailed guides are available in the docs/ directory:

Definitions: Setting services, binding interfaces, parameters, and callbacks.
Resolvers: Managing complex auto-wiring and type conflicts.
Injector: Creating fresh instances and invoking callables.
Architecture: Internal design, design decisions, and exceptions.

A Note on Assertions

Kaly DI uses PHP assert() for input validation (e.g., checking class existence, definition lock, type compatibility). This is by design: these checks run automatically in development (zend.assertions = 1) but are disabled in production (zend.assertions = -1) for zero overhead.

Ensure your test suite covers your DI configuration to catch mistakes before deployment.

Examples and Testing

Check the unit tests for comprehensive usage examples covering all features.

lekoala / kaly-di

Maintainers

Package info

Statistics

Security