依赖注入模式（Dependency Injection）

目的

用松散耦合的方式来更好的实现可测试、可维护和可扩展的代码。

依赖注入模式：依赖注入（Dependency Injection）是控制反转（Inversion of Control）的一种实现方式。要实现控制反转，通常的解决方案是将创建被调用者实例的工作交由 IoC 容器来完成，然后在调用者中注入被调用者（通过构造器/方法注入实现），这样我们就实现了调用者与被调用者的解耦，该过程被称为依赖注入。

用法

DatabaseConfiguration 被注入 DatabaseConnection 并获取所需的 $config 。如果没有依赖注入模式， 配置将直接创建 DatabaseConnection 。这对测试和扩展来说很不好。

例子

  • Doctrine2 ORM 使用依赖注入。 例如，注入到 Connection 对象的配置。 对于测试而言， 可以轻松的创建可扩展的模拟数据并注入到 Connection 对象中。
  • Symfony 和 Zend Framework 2 已经有了依赖注入的容器。他们通过配置的数组来创建对象，并在需要的地方注入 (在控制器中)。

UML 图

MihvMhMofO.png

代码

您可以在 GitHub 查看这段代码

DatabaseConfiguration.php

  2. <?php
  4. namespace DesignPatterns\Structural\DependencyInjection;
  6. class DatabaseConfiguration
  7. {
  8.     /**
  9.      * @var string
  10.      */
  11.     private $host;
  13.     /**
  14.      * @var int
  15.      */
  16.     private $port;
  18.     /**
  19.      * @var string
  20.      */
  21.     private $username;
  23.     /**
  24.      * @var string
  25.      */
  26.     private $password;
  28.     public function __construct(string $host, int $port, string $username, string $password)
  29.     {
  30.         $this->host = $host;
  31.         $this->port = $port;
  32.         $this->username = $username;
  33.         $this->password = $password;
  34.     }
  36.     public function getHost(): string
  37.     {
  38.         return $this->host;
  39.     }
  41.     public function getPort(): int
  42.     {
  43.         return $this->port;
  44.     }
  46.     public function getUsername(): string
  47.     {
  48.         return $this->username;
  49.     }
  51.     public function getPassword(): string
  52.     {
  53.         return $this->password;
  54.     }
  55. }

DatabaseConnection.php

  2. <?php
  4. namespace DesignPatterns\Structural\DependencyInjection;
  6. class DatabaseConnection
  7. {
  8.     /**
  9.      * @var DatabaseConfiguration
  10.      */
  11.     private $configuration;
  13.     /**
  14.      * @param DatabaseConfiguration $config
  15.      */
  16.     public function __construct(DatabaseConfiguration $config)
  17.     {
  18.         $this->configuration = $config;
  19.     }
  21.     public function getDsn(): string
  22.     {
  23.         // 这仅仅是演示，而不是一个真正的  DSN
  24.         // 注意，这里只使用了注入的配置。 所以，
  25.         // 这里是关键的分离关注点。
  27.         return sprintf(
  28.             '%s:%s@%s:%d',
  29.             $this->configuration->getUsername(),
  30.             $this->configuration->getPassword(),
  31.             $this->configuration->getHost(),
  32.             $this->configuration->getPort()
  33.         );
  34.     }
  35. }

测试

Tests/DependencyInjectionTest.php

  2. <?php
  4. namespace DesignPatterns\Structural\DependencyInjection\Tests;
  6. use DesignPatterns\Structural\DependencyInjection\DatabaseConfiguration;
  7. use DesignPatterns\Structural\DependencyInjection\DatabaseConnection;
  8. use PHPUnit\Framework\TestCase;
  10. class DependencyInjectionTest extends TestCase
  11. {
  12.     public function testDependencyInjection()
  13.     {
  14.         $config = new DatabaseConfiguration('localhost', 3306, 'domnikl', '1234');
  15.         $connection = new DatabaseConnection($config);
  17.         $this->assertEquals('domnikl:1234@localhost:3306', $connection->getDsn());
  18.     }
  19. }