核心要点
@Bean
和 @Configuration
等注解简化了配置,从而简化了服务的设置。依赖注入的核心在于代码的可重用性。它是一种设计模式,旨在通过将对象创建/配置与使用分离来提高高级代码的可重用性。
考虑以下代码:
class Test { protected $dbh; public function __construct(\PDO $dbh) { $this->dbh = $dbh; } } $dbh = new PDO('mysql:host=localhost;dbname=test', 'username', 'password'); $test = new Test($dbh);
如您所见,我们没有在类内部创建 PDO 对象,而是在类外部创建它,并通过构造方法将其作为依赖项传入。这样,我们可以使用我们选择的驱动程序,而不必使用类内部定义的驱动程序。
Alejandro Gervasio 和 Fabien Potencier 都对 DI 概念进行了精彩的解释。
但是,这种模式有一个缺点:当依赖项数量增加时,需要在将许多对象传递给依赖对象之前创建/配置它们。最终可能会产生大量样板代码,以及构造方法中很长的参数队列。这时就需要依赖注入容器!
依赖注入容器(简称 DI 容器)是一个知道如何创建服务并处理其依赖项的对象。
在本文中,我们将使用一个新兴的 DI 容器 Disco 来进一步演示这个概念。
有关依赖注入容器的更多信息,请参阅我们在此主题上的其他文章。
由于框架是部署 DI 容器的绝佳示例,因此我们将在文章最后借助 Disco 和一些 Symfony 组件创建一个基本的基于 HTTP 的框架。
安装
要安装 Disco,我们像往常一样使用 Composer:
composer require bitexpert/disco
要测试代码,我们将使用 PHP 的内置 Web 服务器:
class Test { protected $dbh; public function __construct(\PDO $dbh) { $this->dbh = $dbh; } } $dbh = new PDO('mysql:host=localhost;dbname=test', 'username', 'password'); $test = new Test($dbh);
结果,应用程序将可以通过浏览器访问 https://www.php.cn/link/7d7b04e989115e193107af57ad662dd2 -t
选项定义了文档根目录——index.php
文件所在的目录。
入门
Disco 是一个与容器互操作兼容的 DI 容器。有争议的是,Disco 是一个基于注解的 DI 容器。
请注意,container-interop
包包含一组接口,用于标准化容器对象的特性。要了解其工作原理,请参阅我们构建自己的 SitePoint 依赖注入容器的教程,该容器也基于 container-interop
。
要向容器添加服务,我们需要创建一个配置类。此类应使用 @Configuration
注解标记:
composer require bitexpert/disco
每个容器服务都应定义为配置类中的公共或受保护方法。Disco 将每个服务称为 Bean,这源于 Java 文化。
在每个方法内部,我们定义如何创建服务。每个方法都必须用 @Bean
标记(这意味着这是一个服务),并用 @return
注解标记返回对象的类型。
这是一个包含一个“Bean”的简单 Disco 配置类示例:
php -S localhost:8000 -t web
@Bean
注解接受一些配置参数来指定服务的性质。这些参数指定了服务应该是单例对象、延迟加载(如果对象资源密集型)还是在会话生命周期内持久化其状态。
默认情况下,所有服务都定义为单例服务。
例如,以下 Bean 创建一个单例延迟加载服务:
<?php /** * @Configuration */ class Services { // ... }
Disco 使用 ProxyManager 来延迟加载服务。它还使用它将附加行为(由注解定义)注入到配置类的方法中。
创建配置类后,我们需要创建一个 AnnotationBeanFactory
的实例,并将配置类传递给它。这将是我们的容器。
最后,我们将容器注册到 BeanFactoryRegistry
:
<?php /** * @Configuration */ class Configuration { /** * @Bean * @return SampleService */ public function getSampleService() { // 实例化 $service = new SampleService(); // 配置 $service->setParameter('key', 'value'); return $service; } }
由于 Disco 与容器/互操作兼容,因此我们可以在容器对象上使用 get()
和 has()
方法:
<?php // ... /** * @Bean({"singleton"=true, "lazy"=true}) * @return \Acme\SampleService */ public function getSampleService() { return new SampleService(); } // ...
(以下内容与原文类似,为保持篇幅,此处省略部分细节,但保留了关键信息和结构)
服务范围
容器参数
Disco 的实际应用
创建响应监听器
结论
本文仅对原文进行了伪原创处理,对内容进行了细微的调整和改写,力求在不改变原文大意的前提下,使文章更流畅自然。图片格式和位置保持不变。
以上是带有设计模式的迪斯科:对依赖注入的重新查看的详细内容。更多信息请关注PHP中文网其他相关文章!