sixx/dependency-injection

Simple Dependency Injection in php

0.0.3 2016-05-31 03:36 UTC

Requires

• php: >=5.6.0

MIT

• Yuri Nasyrov

• dependency injection
• php
• ioc

README

Simple Dependency Injection for you php project

INSTALLATION WITH COMPOSER

composer require sixx/dependency-injection

EXAMPLE

Constructor Injection

<?php
    require_once __DIR__ . "/vendor/autoload.php";
    
class FirstClass
{
    protected $test;

    public function __construct(TestInterface $test)
    {
        $this->test = $test;
    }

    public function getTest()
    {
        return $this->test;
    }
}

interface TestInterface
{
}

class Test implements TestInterface
{
}

use \Sixx\DependencyInjection\Inject;
// For first you must bind your injection
Inject::bind("TestInterface", "Test");

$class = Inject::instantiation("FirstClass");
var_dump($class->getTest() instanceof Test); // must return true

Initializer methods

<?php
require_once __DIR__ . "/vendor/autoload.php";

class FirstClass
{
    protected $test;

    public function test(TestInterface $test)
    {
        $this->test = $test;
        return $this;
    }

    public function getTest()
    {
        return $this->test;
    }
}

interface TestInterface
{
}

class Test implements TestInterface
{
}

use \Sixx\DependencyInjection\Inject;
// For first you must bind your injection
Inject::bindByArray(["TestInterface" => "Test"]);

$class = Inject::method("FirstClass", "test");
var_dump($class->getTest() instanceof Test); // must return true

Initializer properties

Property must be public and must have attribute @var with needed Class or Interface name

<?php
require_once __DIR__ . "/vendor/autoload.php";

class FirstClass
{
    /**
     * @var TestInterface
     */
    public $test;

    public function getTest()
    {
        return $this->test;
    }
}

interface TestInterface
{
}

class Test implements TestInterface
{
}

use \Sixx\DependencyInjection\Inject;
// For first you must bind your injection
Inject::bindByArray(["TestInterface" => "Test"]);

$class = Inject::instantiation("FirstClass");
var_dump($class->getTest() instanceof Test); // must return true

Service Locator

<?php
require_once __DIR__ . "/vendor/autoload.php";

class FirstClass implements FirstClassInterface
{
    /**
     * @var TestInterface
     */
    public $test;

    public function getTest()
    {
        return $this->test;
    }
}

interface FirstClassInterface
{

}

interface TestInterface
{
}

class Test implements TestInterface
{
}

use \Sixx\DependencyInjection\Inject;
// For first you must bind your injection
Inject::bindByArray(["TestInterface" => "Test", "FirstClassInterface" => "FirstClass"]);

$class = Inject::instantiation("FirstClassInterface");
var_dump($class instanceof FirstClass); // must return true

Different classes to one interface via DocComment

<?php
require_once __DIR__ . "/vendor/autoload.php";

interface SomeInterface
{

}

class First implements SomeInterface
{

}

class Second implements SomeInterface
{

}

class A
{
    /**
     * @thisAnnotationForSecondClass
     * @var SomeInterface
     */
    public $secondVariable;

    protected $firstVariable;

    /**
     * A constructor.
     * @thisAnnotatnionForFristClass
     * @param SomeInterface $my
     */
    public function __construct(SomeInterface $my)
    {
        $this->firstVariable = $my;
    }

    public function getFirst()
    {
        return $this->firstVariable;
    }
}

use \Sixx\DependencyInjection\Inject;
Inject::bindByArray(["SomeInterface" => ["thisAnnotatnionForFristClass" => "First", "thisAnnotationForSecondClass" => "Second"]]);

$class = Inject::instantiation("A");
var_dump($class->secondVariable instanceof Second); // must return true
var_dump($class->getFirst() instanceof First); // must return true