README

A lightweight service container for WordPress plugins and themes, inspired by Laravel's and other modern PHP frameworks’ dependency injection containers.
It allows you to bind classes, singletons, and closures, and automatically resolves dependencies via constructor injection.

Purpose

This container is a core part of the Sefra WordPress Plugin Starter Kit, providing dependency injection and service management for plugins.

Documentation

If you have a WordPress plugin and want to integrate Sefra Container to manage dependency injection, check this guide: How To Use Sefra Container

If you’re starting a new plugin, you might find this starter kit useful:

• repository: Sefra WordPress Plugin Starter Kit
• documentation on it built: documentation

Installation

Use Composer to install:

composer require sefra/container

Usage

use Sefra\Core\Container;

// Get container instance
$container = Container::getInstance();

// Bind a class
$container->bind(App\Services\MyService::class);

// Bind a singleton
$container->singleton(App\Services\MySingletonService::class);

// Resolve an instance
$service = $container->get(App\Services\MyService::class);

Constructor Injection

Dependencies are automatically resolved:

class Logger {
    public function log($message) { /* ... */ }
}

class Mailer {
    public function __construct(Logger $logger) { $this->logger = $logger; }
}

$mailer = $container->resolve(Mailer::class); // Logger is injected automatically

Restrictions

Injecting the container itself into services is forbidden to prevent tight coupling.

Circular dependencies are detected and will throw an exception.

License

MIT