服务提供者

Testing Is Documentation

tests/Di/ProviderTest.php服务提供者 - 图1

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

服务提供者将服务注入到 IOC 容器中，通常来说服务会依赖一些配置和调用其它服务等完成组装，还有有一定复杂度。

我们可以为服务定义一组配套的服务提供者，可以免去配置服务的成本，开发起来很愉悦。

Uses

  1. <?php
  3. use Leevel\Di\Container;
  4. use Leevel\Di\IContainer;
  5. use Leevel\Di\Provider;

基本使用方法

服务提供者通过 register 完成服务注册。

fixture 定义

Tests\Di\PrividerTest

  1. namespace Tests\Di;
  3. class PrividerTest extends Provider
  4. {
  5.     public function register(): void
  6.     {
  7.         $this->container->singleton('foo', function ($container) {
  8.             return new PrividerService1($container);
  9.         });
  10.     }
  12.     public function bootstrap(): void
  13.     {
  14.         $_SERVER['test.privider'] = 'bootstrap';
  15.     }
  17.     public static function providers(): array
  18.     {
  19.         return [
  20.             'foo' => [
  21.                 'bar',
  22.                 'hello',
  23.             ],
  24.         ];
  25.     }
  26. }

Tests\Di\PrividerService1

  1. namespace Tests\Di;
  3. class PrividerService1
  4. {
  5.     public function __construct(IContainer $container)
  6.     {
  7.     }
  9.     public function hello()
  10.     {
  11.         return 'world';
  12.     }
  13. }
  1. public function testBaseUse(): void
  2. {
  3.     $test = new PrividerTest($container = new Container());
  5.     $this->assertInstanceof(IContainer::class, $test->container());
  6.     $this->assertInstanceof(Container::class, $test->container());
  8.     $test->register();
  10.     $this->assertSame('world', $container->make('foo')->hello());
  11.     $this->assertSame('world', $container->make('bar')->hello());
  12.     $this->assertSame('world', $container->make('hello')->hello());
  14.     $this->assertFalse($test->isDeferred());
  15. }

延迟服务提供者

fixture 定义

Tests\Di\PrividerTest2

  1. namespace Tests\Di;
  3. class PrividerTest2 extends Provider
  4. {
  5.     public function register(): void
  6.     {
  7.         $this->container->singleton('world', function ($container) {
  8.             return new PrividerService2();
  9.         });
  10.     }
  12.     public static function providers(): array
  13.     {
  14.         return [
  15.             'world' => 'hello',
  16.         ];
  17.     }
  19.     public static function isDeferred(): bool
  20.     {
  21.         return true;
  22.     }
  23. }

Tests\Di\PrividerService2

  1. namespace Tests\Di;
  3. class PrividerService2
  4. {
  5.     public function foo()
  6.     {
  7.         return 'bar';
  8.     }
  9. }
  1. public function testDeferred(): void
  2. {
  3.     $test = new PrividerTest2($container = new Container());
  5.     $this->assertInstanceof(IContainer::class, $test->container());
  6.     $this->assertInstanceof(Container::class, $test->container());
  8.     $test->register();
  10.     $this->assertSame('bar', $container->make('world')->foo());
  11.     $this->assertSame('hello', $container->make('hello'));
  13.     $container->alias($test->providers());
  15.     $this->assertSame('bar', $container->make('hello')->foo());
  16.     $this->assertTrue($test->isDeferred());
  17. }

bootstrap 服务注册后的引导程序

  1. public function testBootstrap(): void
  2. {
  3.     $test = new PrividerTest(new Container());
  5.     $this->assertInstanceof(IContainer::class, $test->container());
  6.     $this->assertInstanceof(Container::class, $test->container());
  8.     if (isset($_SERVER['test.privider'])) {
  9.         unset($_SERVER['test.privider']);
  10.     }
  12.     $test->bootstrap();
  13.     $this->assertSame('bootstrap', $_SERVER['test.privider']);
  15.     if (isset($_SERVER['test.privider'])) {
  16.         unset($_SERVER['test.privider']);
  17.     }
  18. }