IOC 容器

Testing Is Documentation

tests/Di/ContainerTest.phpIOC 容器 - 图1

IOC 容器是整个框架最核心的部分，负责服务的管理和解耦。

目前系统所有的关键服务都接入了 IOC 容器，包括控制器、Console 命令行。

Uses

  1. <?php
  3. use Leevel\Di\Container;
  4. use Leevel\Di\ICoroutine;
  5. use stdClass;

闭包绑定

闭包属于惰性，真正使用的时候才会执行。

我们可以通过 bind 来绑定一个闭包，通过 make 来运行服务，第二次运行如果是单例则直接使用生成后的结果，否则会每次执行闭包的代码。

通常来说，系统大部分服务都是单例来提升性能和共享。

  1. public function testBindClosure(): void
  2. {
  3.     $container = new Container();
  5.     $container->bind('foo', function () {
  6.         return 'bar';
  7.     });
  9.     $this->assertSame('bar', $container->make('foo'));
  10. }

闭包绑定单例

  1. public function testSingletonClosure(): void
  2. {
  3.     $container = new Container();
  4.     $singleton = new stdClass();
  5.     $container->singleton('singleton', function () use ($singleton) {
  6.         return $singleton;
  7.     });
  9.     $this->assertSame($singleton, $container->make('singleton'));
  10.     $this->assertSame($singleton, $container->make('singleton'));
  11. }

类直接生成本身

一个独立的类可以直接生成，而不需要提前注册到容器中。

fixture 定义

Tests\Di\Fixtures\Test1

  1. namespace Tests\Di\Fixtures;
  3. class Test1
  4. {
  5. }
  1. public function testClass(): void
  2. {
  3.     $container = new Container();
  5.     $this->assertInstanceOf(Test1::class, $container->make(Test1::class));
  6. }

类单例

类也可以注册为单例。

  1. public function testSingletonClass(): void
  2. {
  3.     $container = new Container();
  4.     $container->singleton(Test1::class);
  6.     $this->assertSame($container->make(Test1::class), $container->make(Test1::class));
  7. }

接口绑定

可以为接口绑定实现。

fixture 定义

Tests\Di\Fixtures\ITest2

  1. namespace Tests\Di\Fixtures;
  3. interface ITest2
  4. {
  5. }

Tests\Di\Fixtures\Test2

  1. namespace Tests\Di\Fixtures;
  3. class Test2 implements ITest2
  4. {
  5. }
  1. public function testInterface(): void
  2. {
  3.     $container = new Container();
  4.     $container->bind(ITest2::class, Test2::class);
  6.     $this->assertInstanceOf(ITest2::class, $container->make(ITest2::class));
  7.     $this->assertInstanceOf(ITest2::class, $container->make(Test2::class));
  8. }

接口绑定接口作为构造器参数

接口可以作为控制器参数来做依赖注入。

fixture 定义

Tests\Di\Fixtures\Test3

  1. namespace Tests\Di\Fixtures;
  3. class Test3 implements ITest3
  4. {
  5.     public $arg1;
  7.     public function __construct(ITest2 $arg1)
  8.     {
  9.         $this->arg1 = $arg1;
  10.     }
  11. }

通过 Test3 的构造函数注入 ITest2 的实现 Test2，通过 IOC 容器可以实现代码解耦。

  1. public function testInterface2(): void
  2. {
  3.     $container = new Container();
  4.     $container->bind(ITest2::class, Test2::class);
  6.     $this->assertInstanceOf(ITest2::class, $test2 = $container->make(Test3::class)->arg1);
  7.     $this->assertInstanceOf(Test2::class, $test2);
  8. }

绑定闭包第一个参数为 IOC 容器本身

  1. public function testContainerAsFirstArgs(): void
  2. {
  3.     $container = new Container();
  4.     $container->bind('test', function ($container) {
  5.         return $container;
  6.     });
  8.     $this->assertSame($container, $container->make('test'));
  9. }

数组访问 ArrayAccess 支持

  1. public function testArrayAccess(): void
  2. {
  3.     $container = new Container();
  4.     $container['foo'] = function () {
  5.         return 'bar';
  6.     };
  8.     $this->assertTrue(isset($container['foo']));
  9.     $this->assertSame('bar', $container['foo']);
  10.     unset($container['foo']);
  11.     $this->assertFalse(isset($container['foo']));
  12. }

alias 设置别名

  1. public function testAliases(): void
  2. {
  3.     $container = new Container();
  4.     $container['foo'] = 'bar';
  5.     $container->alias('foo', 'foo2');
  6.     $container->alias('foo', ['foo3', 'foo4']);
  7.     $container->alias(['foo' => ['foo5', 'foo6']]);
  8.     $container->alias(['foo' => 'foo7']);
  10.     $this->assertSame('bar', $container->make('foo'));
  11.     $this->assertSame('bar', $container->make('foo2'));
  12.     $this->assertSame('bar', $container->make('foo3'));
  13.     $this->assertSame('bar', $container->make('foo4'));
  14.     $this->assertSame('bar', $container->make('foo5'));
  15.     $this->assertSame('bar', $container->make('foo6'));
  16.     $this->assertSame('bar', $container->make('foo7'));
  17. }

make 服务容器返回对象支持参数

  1. public function testMakeWithArgs(): void
  2. {
  3.     $container = new Container();
  4.     $container['foo'] = function ($container, $arg1, $arg2) {
  5.         return [
  6.             $arg1,
  7.             $arg2,
  8.         ];
  9.     };
  11.     $this->assertSame([1, 2], $container->make('foo', [1, 2, 3]));
  12. }

bind 注册到容器支持覆盖

  1. public function testOverridden(): void
  2. {
  3.     $container = new Container();
  4.     $container['foo'] = 'bar';
  5.     $this->assertSame('bar', $container['foo']);
  7.     $container['foo'] = 'bar2';
  8.     $this->assertSame('bar2', $container['foo']);
  9. }

instance 注册为实例

  1. public function testInstance(): void
  2. {
  3.     $container = new Container();
  4.     $instance = new stdClass();
  5.     $container->instance('foo', $instance);
  7.     $this->assertSame($instance, $container->make('foo'));
  8. }

默认参数支持

fixture 定义

Tests\Di\Fixtures\Test5

  1. namespace Tests\Di\Fixtures;
  3. class Test5 implements ITest3
  4. {
  5.     public $arg1;
  7.     public $arg2;
  9.     public function __construct(Test3 $arg1, $arg2 = 'hello default')
  10.     {
  11.         $this->arg1 = $arg1;
  12.         $this->arg2 = $arg2;
  13.     }
  14. }

Tests\Di\Fixtures\ITest3

  1. namespace Tests\Di\Fixtures;
  3. interface ITest3
  4. {
  5. }
  1. public function testDefaultArgs(): void
  2. {
  3.     $container = new Container();
  4.     $container->bind(ITest2::class, Test2::class);
  5.     $container->bind('foo', Test5::class);
  6.     $test5 = $container->make('foo');
  8.     $this->assertInstanceOf(ITest3::class, $test5);
  9.     $this->assertSame('hello default', $test5->arg2);
  10. }

必填参数校验

fixture 定义

Tests\Di\Fixtures\Test6

  1. namespace Tests\Di\Fixtures;
  3. class Test6
  4. {
  5.     public $arg1;
  7.     public $arg2;
  9.     public $arg3;
  11.     public function __construct($arg1, $arg2, $arg3)
  12.     {
  13.         $this->arg1 = $arg1;
  14.         $this->arg2 = $arg2;
  15.         $this->arg3 = $arg3;
  16.     }
  17. }
  1. public function testArgsRequiredContainerInvalidArgumentException(): void
  2. {
  3.     $this->expectException(\Leevel\Di\ContainerInvalidArgumentException::class);
  4.     $this->expectExceptionMessage(
  5.         'There are 3 required args,but 0 gived.'
  6.     );
  8.     $container = new Container();
  9.     $container->make(Test6::class, []);
  10. }

接口必须绑定服务

  1. public function testInterfaceContainerInvalidArgumentException(): void
  2. {
  3.     $this->expectException(\Leevel\Di\ContainerInvalidArgumentException::class);
  4.     $this->expectExceptionMessage(
  5.         'Interface Tests\\Di\\Fixtures\\ITest2 cannot be normalize because not binded.'
  6.     );
  8.     $container = new Container();
  9.     $container->make(ITest2::class, []);
  10. }

call 回调自动依赖注入

fixture 定义

Tests\Di\Fixtures\Test7

  1. namespace Tests\Di\Fixtures;
  3. class Test7
  4. {
  5. }

Tests\Di\Fixtures\Test8

  1. namespace Tests\Di\Fixtures;
  3. class Test8 implements ITest8
  4. {
  5.     public function func1()
  6.     {
  7.         return func_get_args();
  8.     }
  10.     public function func2($arg1 = 'hello')
  11.     {
  12.         return func_get_args();
  13.     }
  15.     public static function staticFunc3()
  16.     {
  17.         return func_get_args();
  18.     }
  20.     public function handle()
  21.     {
  22.         return ['call handle'];
  23.     }
  24. }
  1. public function testCall(): void
  2. {
  3.     $container = new Container();
  4.     $result = $container->call(function (Test7 $arg1, array $arg2 = []) {
  5.         return func_get_args();
  6.     });
  8.     $this->assertInstanceOf(Test7::class, $result[0]);
  9.     $this->assertSame([], $result[1]);
  11.     $result = $container->call(function (Test7 $arg1, array $arg2 = [], $arg3 = null) {
  12.         return func_get_args();
  13.     }, ['arg3' => 'hello']);
  15.     $this->assertInstanceOf(Test7::class, $result[0]);
  16.     $this->assertSame([], $result[1]);
  17.     $this->assertSame('hello', $result[2]);
  19.     $test7 = new Test7();
  20.     $result = $container->call(function (Test7 $arg1, $arg2 = 'hello') {
  21.         return func_get_args();
  22.     }, [Test7::class => $test7, 'arg2' => 'hello world']);
  24.     $this->assertSame($test7, $result[0]);
  25.     $this->assertSame('hello world', $result[1]);
  27.     $test8 = new Test8();
  28.     $result = $container->call(function ($arg1, $arg2, $arg3, ?ITest8 $arg4 = null, ?Test8 $arg5 = null) {
  29.         return func_get_args();
  30.     }, ['arg1' => 'foo', 'arg3' => 'world2', Test8::class => $test8]);
  32.     $this->assertSame('foo', $result[0]);
  33.     $this->assertNull($result[1]);
  34.     $this->assertSame('world2', $result[2]);
  35.     $this->assertNull($result[3]);
  36.     $this->assertSame($result[4], $test8);
  37. }

call 回调自动依赖注入支持字符串或者数组类回调

  1. public function testCallWithArrayOrString(): void
  2. {
  3.     $container = new Container();
  5.     $result = $container->call([Test8::class, 'func1'], ['foo', 'bar']);
  6.     $this->assertSame(['foo', 'bar'], $result);
  8.     $result = $container->call(Test8::class.'@func1', ['foo', 'bar']);
  9.     $this->assertSame(['foo', 'bar'], $result);
  11.     $result = $container->call([Test8::class], ['foo', 'bar']);
  12.     $this->assertSame(['call handle'], $result);
  14.     $result = $container->call(Test8::class.'@', ['foo', 'bar']);
  15.     $this->assertSame(['call handle'], $result);
  17.     $result = $container->call(Test8::class.'@func2');
  18.     $this->assertSame('hello', $result[0]);
  20.     $result = $container->call(Test8::class.'@func2', ['world', 'foo', 'bar']);
  21.     $this->assertSame('hello', $result[0]);
  22.     $this->assertSame('world', $result[1]);
  23.     $this->assertSame('foo', $result[2]);
  24.     $this->assertSame('bar', $result[3]);
  26.     $result = $container->call(Test8::class.'@func2', ['world', 'arg1' => 'foo', 'bar']);
  27.     $this->assertSame('foo', $result[0]);
  28.     $this->assertSame('world', $result[1]);
  29.     $this->assertSame('bar', $result[2]);
  30. }

call 回调自动依赖注入支持实例和方法数组回调

  1. public function testCallWithCallableArray(): void
  2. {
  3.     $container = new Container();
  4.     $test8 = new Test8();
  5.     $result = $container->call([$test8, 'func1'], ['foo', 'bar']);
  7.     $this->assertSame(['foo', 'bar'], $result);
  8. }

call 回调自动依赖注入支持静态回调

  1. public function testCallStatic(): void
  2. {
  3.     $container = new Container();
  5.     $result = $container->call(Test8::class.'::staticFunc3', ['hello', 'world']);
  6.     $this->assertSame(['hello', 'world'], $result);
  7. }

remove 删除服务和实例

  1. public function testRemove(): void
  2. {
  3.     $container = new Container();
  5.     $test8 = new Test8();
  6.     $container->instance(Test8::class, $test8);
  7.     $this->assertTrue($container->exists(Test8::class));
  9.     $container->remove(Test8::class);
  10.     $this->assertFalse($container->exists(Test8::class));
  11. }

实例数组访问 ArrayAccess.offsetUnset 支持

  1. public function testUnsetInstances(): void
  2. {
  3.     $container = new Container();
  5.     $container->instance('foo', 'bar');
  6.     $container->alias('foo', 'foo2');
  7.     $container->alias('foo', 'foo3');
  9.     $this->assertTrue(isset($container['foo']));
  10.     $this->assertTrue(isset($container['foo2']));
  11.     $this->assertTrue(isset($container['foo3']));
  13.     unset($container['foo']);
  15.     $this->assertFalse(isset($container['foo']));
  16.     $this->assertFalse(isset($container['foo2']));
  17.     $this->assertFalse(isset($container['foo3']));
  18. }

类依赖注入构造器必须为 public

fixture 定义

Tests\Di\Fixtures\Test9

  1. namespace Tests\Di\Fixtures;
  3. class Test9
  4. {
  5.     protected function __construct()
  6.     {
  7.     }
  9.     public function hello()
  10.     {
  11.         return 'world9';
  12.     }
  13. }
  1. public function testNotInstantiable(): void
  2. {
  3.     $this->expectException(\InvalidArgumentException::class);
  4.     $this->expectExceptionMessage(
  5.         'Class Tests\\Di\\Fixtures\\Test9 is not instantiable.'
  6.     );
  8.     $container = new Container();
  9.     $this->assertSame('world9', $container->make(Test9::class)->hello());
  10. }

bind 注册到容器可以支持各种数据

  1. public function testMakeServiceBool(): void
  2. {
  3.     $container = new Container();
  5.     $container->bind('foo', false);
  6.     $this->assertFalse($container->make('foo'));
  7. }

bind 注册到容器支持传递数组来设置别名

  1. public function testBindArrayAsAlias(): void
  2. {
  3.     $container = new Container();
  4.     $container->bind(['foo' => 'bar'], false);
  6.     $this->assertFalse($container->make('foo'));
  7.     $this->assertFalse($container->make('bar'));
  8. }

依赖注入的方法中类参数不存在例子

fixture 定义

Tests\Di\Fixtures\Test10

  1. namespace Tests\Di\Fixtures;
  3. class Test10
  4. {
  5.     public function hello(TestNotFound $test)
  6.     {
  7.         return 'test10';
  8.     }
  9. }
  1. public function testParseReflectionException(): void
  2. {
  3.     $this->expectException(\InvalidArgumentException::class);
  4.     $this->expectExceptionMessage(
  5.         'Class Tests\\Di\\Fixtures\\TestNotFound does not exist'
  6.     );
  8.     $container = new Container();
  9.     $container->call([new Test10(), 'hello']);
  10. }

instance 注册为实例支持传递数组来设置别名

  1. public function testInstanceWithArray(): void
  2. {
  3.     $container = new Container();
  4.     $instance = new stdClass();
  5.     $container->instance(['foo' => 'bar'], $instance);
  7.     $this->assertSame($instance, $container->make('foo'));
  8.     $this->assertSame($instance, $container->make('bar'));
  9. }

instance 注册为实例未传递第二个参数会注册自身

比如说系统中中间件注册。

  1. # Leevel\Session\Provider\Register::middleware
  2. /**
  3.  * 注册 middleware 服务.
  4.  */
  5. protected function middleware(): void;
  1. public function testInstanceItSelf(): void
  2. {
  3.     $container = new Container();
  4.     $container->instance('foo');
  5.     $this->assertSame('foo', $container->make('foo'));
  7.     $container->instance('Leevel\\Foo\\Middleware\\Bar');
  8.     $this->assertSame('Leevel\\Foo\\Middleware\\Bar', $container->make('Leevel\\Foo\\Middleware\\Bar'));
  9. }

参数为类实例例子

fixture 定义

Tests\Di\Fixtures\Test20

  1. namespace Tests\Di\Fixtures;
  3. class Test20
  4. {
  5.     public function handle(Test21 $arg1, Test22 $arg2)
  6.     {
  7.         return ['test21' => $arg1->prop, 'test22' => $arg2->prop];
  8.     }
  9. }

Tests\Di\Fixtures\Test21

  1. namespace Tests\Di\Fixtures;
  3. class Test21
  4. {
  5.     public $prop;
  7.     public function __construct(?string $prop = null)
  8.     {
  9.         $this->prop = $prop;
  10.     }
  11. }

Tests\Di\Fixtures\Test22

  1. namespace Tests\Di\Fixtures;
  3. class Test22
  4. {
  5.     public $prop;
  7.     public function __construct(?string $prop = null)
  8.     {
  9.         $this->prop = $prop;
  10.     }
  11. }
  1. public function testCallWithClassArgsAndItInstance(): void
  2. {
  3.     $container = new Container();
  4.     $obj = new Test20();
  5.     $args = [new Test21('hello'), new Test22('world')];
  6.     $result = $container->call([$obj, 'handle'], $args);
  8.     $this->assertSame(['test21' => 'hello', 'test22' => 'world'], $result);
  9. }

参数为类实例例子和其它参数混合

fixture 定义

Tests\Di\Fixtures\Test23

  1. namespace Tests\Di\Fixtures;
  3. class Test23
  4. {
  5.     public function handle(Test24 $arg1, Test25 $arg2, string $arg3)
  6.     {
  7.         return ['test24' => $arg1->prop, 'test25' => $arg2->prop, 'three' => $arg3];
  8.     }
  9. }

Tests\Di\Fixtures\Test24

  1. namespace Tests\Di\Fixtures;
  3. class Test24
  4. {
  5.     public $prop;
  7.     public function __construct(?string $prop = null)
  8.     {
  9.         $this->prop = $prop;
  10.     }
  11. }

Tests\Di\Fixtures\Test25

  1. namespace Tests\Di\Fixtures;
  3. class Test25
  4. {
  5.     public $prop;
  7.     public function __construct(?string $prop = null)
  8.     {
  9.         $this->prop = $prop;
  10.     }
  11. }
  1. public function testCallWithClassArgsAndItInstanceAndMore(): void
  2. {
  3.     $container = new Container();
  4.     $obj = new Test23();
  5.     $args = [new Test24('hello'), new Test25('world'), 'more'];
  6.     $result = $container->call([$obj, 'handle'], $args);
  8.     $this->assertSame(['test24' => 'hello', 'test25' => 'world', 'three' => 'more'], $result);
  9. }

setCoroutine 注册到容器支持注册到当前协程

fixture 定义

Tests\Di\Fixtures\Test26

  1. namespace Tests\Di\Fixtures;
  3. class Test26
  4. {
  5. }
  1. public function testCoroutine(): void
  2. {
  3.     $coroutine = $this->createMock(ICoroutine::class);
  5.     $coroutine->method('context')->willReturn(true);
  6.     $this->assertTrue($coroutine->context(Test26::class));
  8.     $coroutine->method('cid')->willReturn(2);
  9.     $this->assertSame(2, $coroutine->cid());
  11.     $container = new Container();
  12.     $container->setCoroutine($coroutine);
  13.     $this->assertInstanceOf(ICoroutine::class, $container->getCoroutine());
  15.     $container->instance('test', new Test26());
  17.     $this->assertInstanceOf(Test26::class, $container->make('test'));
  18.     $this->assertTrue($container->existsCoroutine('test'));
  19. }

removeCoroutine 删除协程上下文服务和实例

  1. public function testRemoveCoroutine(): void
  2. {
  3.     $coroutine = $this->createMock(ICoroutine::class);
  5.     $coroutine->method('context')->willReturn(true);
  6.     $this->assertTrue($coroutine->context(Test26::class));
  8.     $coroutine->method('cid')->willReturn(2);
  9.     $this->assertSame(2, $coroutine->cid());
  11.     $container = new Container();
  12.     $container->setCoroutine($coroutine);
  14.     $container->instance('test', new Test26());
  16.     $this->assertInstanceOf(Test26::class, $container->make('test'));
  17.     $this->assertTrue($container->existsCoroutine('test'));
  19.     $container->removeCoroutine('test');
  20.     $this->assertFalse($container->existsCoroutine('test'));
  21. }

remove 也支持删除协程上下文服务和实例

  1. public function testRemoveCoroutineByRemove(): void
  2. {
  3.     $coroutine = $this->createMock(ICoroutine::class);
  5.     $coroutine->method('context')->willReturn(true);
  6.     $this->assertTrue($coroutine->context(Test26::class));
  8.     $coroutine->method('cid')->willReturn(2);
  9.     $this->assertSame(2, $coroutine->cid());
  11.     $container = new Container();
  12.     $container->setCoroutine($coroutine);
  14.     $container->instance('test', new Test26());
  16.     $this->assertInstanceOf(Test26::class, $container->make('test'));
  17.     $this->assertTrue($container->existsCoroutine('test'));
  19.     $container->remove('test');
  20.     $this->assertFalse($container->existsCoroutine('test'));
  21. }

removeCoroutine 支持删除当前协程上下文所有服务和实例

  1. public function testRemoveCoroutineAll(): void
  2. {
  3.     $coroutine = $this->createMock(ICoroutine::class);
  5.     $coroutine->method('context')->willReturn(true);
  6.     $this->assertTrue($coroutine->context(Test26::class));
  8.     $coroutine->method('cid')->willReturn(2);
  9.     $this->assertSame(2, $coroutine->cid());
  11.     $container = new Container();
  12.     $container->setCoroutine($coroutine);
  14.     $container->instance('test', new Test26());
  16.     $this->assertInstanceOf(Test26::class, $container->make('test'));
  17.     $this->assertTrue($container->existsCoroutine('test'));
  19.     $container->removeCoroutine();
  20.     $this->assertFalse($container->existsCoroutine('test'));
  21. }

singleton 协程例子

  1. public function testCoroutineWasSingleton(): void
  2. {
  3.     $coroutine = $this->createMock(ICoroutine::class);
  5.     $coroutine->method('context')->willReturn(true);
  6.     $this->assertTrue($coroutine->context(Test26::class));
  8.     $coroutine->method('cid')->willReturn(2);
  9.     $this->assertSame(2, $coroutine->cid());
  11.     $container = new Container();
  12.     $container->setCoroutine($coroutine);
  13.     $this->assertInstanceOf(ICoroutine::class, $container->getCoroutine());
  15.     $container->singleton('test', new Test26());
  17.     $this->assertInstanceOf(Test26::class, $container->make('test'));
  18.     $this->assertTrue($container->existsCoroutine('test'));
  19. }

bind 协程例子

  1. public function testBindAsCoroutine(): void
  2. {
  3.     $coroutine = $this->createMock(ICoroutine::class);
  5.     $coroutine->method('context')->willReturn(true);
  6.     $this->assertTrue($coroutine->context('test'));
  8.     $container = new Container();
  9.     $container->setCoroutine($coroutine);
  10.     $this->assertInstanceOf(ICoroutine::class, $container->getCoroutine());
  12.     $container->bind('test', new Test26(), true, true);
  14.     $this->assertInstanceOf(Test26::class, $container->make('test'));
  15.     $this->assertTrue($container->existsCoroutine('test'));
  16. }

make 服务容器返回对象支持类名生成服务

fixture 定义

Tests\Di\Fixtures\Test28

  1. namespace Tests\Di\Fixtures;
  3. class Test28
  4. {
  5.     private $test;
  7.     public function __construct(Test27 $test)
  8.     {
  9.         $this->test = $test;
  10.     }
  12.     public function hello()
  13.     {
  14.         return $this->test->hello();
  15.     }
  16. }
  1. public function testClassArgsASingleClass(): void
  2. {
  3.     $container = new Container();
  4.     $test = $container->make(Test28::class);
  5.     $this->assertSame('world', $test->hello());
  6. }

魔术方法 __get 支持

  1. public function testMagicGet(): void
  2. {
  3.     $container = new Container();
  4.     $container->bind('foo', 'bar');
  6.     $this->assertSame('bar', $container->foo);
  7. }

魔术方法 __set 支持

  1. public function testMagicSet(): void
  2. {
  3.     $container = new Container();
  4.     $container->foo = 'bar';
  6.     $this->assertSame('bar', $container->foo);
  7. }

clear 清理容器

  1. public function testClear(): void
  2. {
  3.     $container = new Container();
  4.     $container->instance('foo', 'bar');
  6.     $this->assertSame('bar', $container->make('foo'));
  7.     $this->assertSame('notfound', $container->make('notfound'));
  9.     $container->clear();
  10.     $this->assertSame('foo', $container->make('foo'));
  11. }

IOC 容器禁止克隆

  1. public function testClone(): void
  2. {
  3.     $this->expectException(\RuntimeException::class);
  4.     $this->expectExceptionMessage(
  5.         'IOC container disallowed clone.'
  6.     );
  8.     $container = new Container();
  9.     $container2 = clone $container;
  10. }

makeProvider 创建服务提供者

fixture 定义

Tests\Di\Fixtures\ProviderTest1

  1. namespace Tests\Di\Fixtures;
  3. use Leevel\Di\IContainer;
  4. use Leevel\Di\Provider;
  6. class ProviderTest1 extends Provider
  7. {
  8.     public function __construct(IContainer $container)
  9.     {
  10.         $_SERVER['testMakeProvider'] = 1;
  11.     }
  13.     public function register(): void
  14.     {
  15.     }
  16. }
  1. public function testMakeProvider(): void
  2. {
  3.     $container = new Container();
  4.     $container->makeProvider(ProviderTest1::class);
  6.     $this->assertSame(1, $_SERVER['testMakeProvider']);
  7.     unset($_SERVER['testMakeProvider']);
  8. }

callProviderBootstrap 执行服务提供者 bootstrap

fixture 定义

Tests\Di\Fixtures\ProviderTest2

  1. namespace Tests\Di\Fixtures;
  3. use Leevel\Di\IContainer;
  4. use Leevel\Di\Provider;
  6. class ProviderTest2 extends Provider
  7. {
  8.     public function __construct(IContainer $container)
  9.     {
  10.     }
  12.     public function bootstrap()
  13.     {
  14.         $_SERVER['testCallProviderBootstrap'] = 1;
  15.     }
  17.     public function register(): void
  18.     {
  19.     }
  20. }
  1. public function testCallProviderBootstrap(): void
  2. {
  3.     $container = new Container();
  4.     $container->callProviderBootstrap(new ProviderTest1($container));
  6.     $this->assertSame(1, $_SERVER['testMakeProvider']);
  7.     unset($_SERVER['testMakeProvider']);
  9.     $container->callProviderBootstrap(new ProviderTest2($container));
  10.     $this->assertSame(1, $_SERVER['testCallProviderBootstrap']);
  11.     unset($_SERVER['testCallProviderBootstrap']);
  12. }

registerProviders 注册服务提供者

  1. public function testRegisterProviders(): void
  2. {
  3.     $container = new Container();
  5.     $this->assertFalse($container->isBootstrap());
  6.     $container->registerProviders([], [], []);
  7.     $this->assertTrue($container->isBootstrap());
  9.     // do nothing
  10.     $container->registerProviders([], [], []);
  11. }

registerProviders 注册服务提供者支持延迟写入

fixture 定义

Tests\Di\Fixtures\DeferredProvider

  1. namespace Tests\Di\Fixtures;
  3. use Leevel\Di\IContainer;
  4. use Leevel\Di\Provider;
  6. class DeferredProvider extends Provider
  7. {
  8.     public function __construct(IContainer $container)
  9.     {
  10.         $_SERVER['testDeferredProvider'] = 1;
  11.     }
  13.     public function register(): void
  14.     {
  15.     }
  16. }
  1. public function testDeferredProvider(): void
  2. {
  3.     $deferredProviders = [
  4.         'test_deferred' => 'Tests\\Di\\Fixtures\\DeferredProvider',
  5.     ];
  7.     $deferredAlias = [
  8.         'Tests\\Di\\Fixtures\\DeferredProvider' => [
  9.             'test_deferred' => 'bar',
  10.         ],
  11.     ];
  13.     $container = new Container();
  15.     $this->assertFalse($container->isBootstrap());
  16.     $container->registerProviders([], $deferredProviders, $deferredAlias);
  17.     $this->assertTrue($container->isBootstrap());
  18.     $this->assertSame('test_deferred', $container->make('bar'));
  19.     $this->assertSame('test_deferred', $container->make('test_deferred'));
  20.     $this->assertSame(1, $_SERVER['testDeferredProvider']);
  22.     unset($_SERVER['testDeferredProvider']);
  23. }