README

php 简洁容器/依赖注入

使用

安装

kos 在 packagist: https://packagist.org.cn/packages/jesusslim/kos

安装

composer require jesusslim/kos

方法

getInstance()

获取 kos\Container 实例。

map($key,$class = null)

将类或闭包映射到容器。

Container::getInstance()->map(Foo::class);
Container::getInstance()->map('foo',Foo::class);
Container::getInstance()->map('bar',function($foo,$bar){return $foo + $bar;});

mapInstance($key,$instance)

将实例映射到容器。

Container::getInstance()->mapInstance('foo',new Foo());

isMapped($key)

get($key,$params = [])

如果 $key 在容器中映射为实例，则返回该实例；

如果 $key 在容器中映射为类，则返回该类的实例；

如果 $key 在容器中映射为闭包，则返回闭包的结果；

如果 $key 在容器中没有映射，则反射 $key 并返回实例/结果；

$params 中的值可以用作类构造函数的参数或闭包的参数；

class Foo{

    private $bar;

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

    public function getBar(){
        return $this->bar;
    }
}
$container = Container::getInstance();

$container->map(Foo::class);
$container->mapInstance('bar',677);
$container->map('sum',function(Foo $foo,$inc){
    return $foo->getBar()+$inc;
});

$foo = $container->get(Foo::class);
/* @var Foo $foo */
echo $foo->getBar();
//result is 677

$foo = $container->get(Foo::class,['bar' => 688]);
echo $foo->getBar();
//result is 688;

echo $container->get('sum',['inc' => 100]);
//result is 777

invoke(Closure $closure,$params = [])

调用闭包，闭包的参数将由容器填充。

echo $container->invoke(function(Foo $foo,$inc){
    return $foo->getBar()+$inc;
},['inc' => 100]);
//result is 777

invokeClass($class,$method,$params = [])

调用类->方法，闭包的参数将由容器填充。

echo $container->invokeClass(Foo::class,'getBar',[]);
//result is 677

其他

kos 是一个简单使用的简洁容器/DI 库。

而 pinject 是一个用于复杂使用的库，如缓存实例、ArrayAccess 实现，以及使用容器进行链式操作/工作流程。