Skip to content

Latest commit

History

4 Commits

Folders and files

NameName
Last commit message
Last commit date

Repository files navigation

Igni logoBuild Status

Igni Container

Licensed under MIT License.

Igni container is a psr-container compliant lightweight service locator pattern implementation.

List of features:

  • Simple usage if you are familiar with psr-container there is no learning-curve required for basic usage
  • Context aware you can define custom instances of services for given use-cases.
  • Auto wiring required dependencies are auto-injected into your service

Installation

composer install igniphp/container

Basic usage

<?php$serviceLocator = newIgni\Container\ServiceLocator();
$serviceLocator->set('my_awesome_service', newstdClass());
$myService = $serviceLocator->get('my_awesome_service');
var_dump($myService === $serviceLocator->get('my_awesome_service')); // returns true

Registering shared service

Shared services are services which are instantiated only once and reference is kept in the registry that way every time service is requested from the container it will return the same instance.

<?phpuseIgni\Container\ServiceLocator;
class Service {
public$a;
publicfunction__construct(int$a = 1) {
$this->a = $a; }
}
$serviceLocator = newServiceLocator();
$serviceLocator->share(Service::class, function() { returnnewService(2); });
var_dump($serviceLocator->get(Service::class)->a === 2); //truevar_dump($serviceLocator->get(Service::class) === $serviceLocator->get(Service::class)); // true

Factored services

Factored services are instantiated every time container is asked for the service.

<?phpuseIgni\Container\ServiceLocator;
class Service {
public$a;
publicfunction__construct(int$a = 1) {
$this->a = $a; }
}
$serviceLocator = newServiceLocator();
$serviceLocator->factory(Service::class, function() { returnnewService(2); });
var_dump($serviceLocator->get(Service::class)->a === 2); //truevar_dump($serviceLocator->get(Service::class) === $serviceLocator->get(Service::class)); // false

Auto-wiring

Auto-wiring allows you to simply pass fully qualified class name and all type-hinted arguments for that class will be resolved automatically by the container.

<?phpuseIgni\Container\ServiceLocator;
class A
{
}
class Service {
public$a;
public$number;
publicfunction__construct(int$number = 7, A$a) {
$this->number = $number;
$this->a = $a; }
}
$serviceLocator = newServiceLocator();
$serviceLocator->share(A::class);
$serviceLocator->share(Service::class);
var_dump($serviceLocator->get(Service::class)->ainstanceof A);// true

That's all folks!

About

Igni container

Topics

Resources

Stars

4 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages