使用 Symfony 组件演示 PHP 中的依赖注入

1. 什么是依赖注入

依赖注入是一种面向对象设计的技术，它可以使得类之间的依赖关系松耦合。通俗地说，依赖注入就是在创建一个实例时，将需要的对象通过构造函数参数或者属性赋值的方式“注入”进去，而不是在类内部通过 new 关键字创建依赖对象。

通过依赖注入，我们能够将对象之间的耦合度大大降低，使得代码更具有灵活性和可扩展性。例如，当我们需要修改一个类的依赖关系的时候，只需要更改适当的构造函数参数或者修改属性值，而不需要考虑类之间的其它依赖关系。

2. Symfony 组件中的依赖注入

Symfony 是一个流行的 PHP 框架，它提供了一套完整的依赖注入组件。这些组件可以独立于 Symfony 框架使用，包括服务容器、组件扫描器、编译器等。

2.1 什么是服务容器

在 Symfony 中，所有的依赖对象都是注册到一个全局的服务容器中。服务容器可以在应用程序范围内统一地管理所有的依赖对象，将对象的创建、配置和获取统一起来，从而提高了代码的可维护性和可测试性。

具体来说，我们可以通过服务容器来注册服务，即创建和配置依赖对象。当我们需要使用这些依赖对象的时候，只需要从服务容器中获取即可，而不需要关心依赖对象的创建和配置过程。

2.2 什么是组件扫描器

在 Symfony 的服务容器中，依赖对象是通过类名进行注册的。当应用程序规模不断扩大的时候，手动注册每一个依赖对象会变得异常繁琐，而且容易出错。这时候，我们可以使用组件扫描器，自动扫描指定目录下的类，并将其注册到服务容器中。

组件扫描器是 Symfony 组件中的一个重要模块，它可以解决依赖对象注册的自动化和集中化问题。例如，我们可以通过以下代码片段来扫描 App\Service 目录下的所有 PHP 文件，并将文件中的服务自动注册到服务容器中。

use Symfony\Component\DependencyInjection\ContainerBuilder;
use Symfony\Component\DependencyInjection\Loader\YamlFileLoader;
use Symfony\Component\Config\FileLocator;
$containerBuilder = new ContainerBuilder();
$loader = new YamlFileLoader($containerBuilder, new FileLocator(__DIR__ . '/config'));
$loader->load('services.yaml');
$containerBuilder->register('service_directory', \App\Service\ServiceDirectory::class)
    ->setArgument('$servicePaths', [
        __DIR__ . '/src/Service/',
    ]);
$scanner = new \Symfony\Component\DependencyInjection\Compiler\ServiceLocatorTagPass($containerBuilder);
$scanner->process(new \Symfony\Component\DependencyInjection\Compiler\CompilerPassConfiguration([
    new \Symfony\Component\DependencyInjection\Compiler\ResolveClassPass(),
    new \Symfony\Component\DependencyInjection\Compiler\AutoRegisterPass(),
    new \Symfony\Component\DependencyInjection\Compiler\AutowirePass(),
    new \Symfony\Component\DependencyInjection\Compiler\RegisterEnvVarProcessorsPass(),
    new \Symfony\Component\DependencyInjection\Compiler\ResolveParameterPlaceHoldersPass(),
    new \Symfony\Component\DependencyInjection\Compiler\ResolveReferencesToAliasesPass(),
    new \Symfony\Component\DependencyInjection\Compiler\RemovePrivateAliasesPass(),
    new \Symfony\Component\DependencyInjection\Compiler\InlineServiceDefinitionsPass(),
]));

2.3 什么是编译器

在 Symfony 的服务容器中，所有的依赖对象都是通过类名进行注册的。但是，在某些情况下，我们并不希望在运行时才进行依赖对象的创建，而是希望在构建时就进行对象的创建，以提高性能。

为了实现这个目标，Symfony 提供了一个编译器，可以在应用程序构建时，预先对服务容器中的依赖对象进行创建和配置，并生成相应的代码缓存文件。这样，在运行时我们就可以直接使用已经编译好的缓存文件，避免了耗时的依赖注入过程。

3. Symfony 组件中的依赖注入示例

在 Symfony 组件中，我们可以通过配置文件的方式来定义依赖对象的创建和配置方法。以下是一个示例的 services.yaml 文件代码：

services:
    # 注册一个名为 "mailer" 的服务
    mailer:
        # 指定类名
        class:     Mailer
        # 指定参数
        arguments: ['%mailer.transport%']
    # 注册一个名为 "mailer.transport" 的服务
    mailer.transport:
        # 指定类名
        class:     SmtpTransport
        # 指定参数
        arguments: ['%mailer.transport.host%', '%mailer.transport.port%']

在上面的例子中，我们注册了两个服务： mailer 和 mailer.transport。其中 mailer 依赖于 mailer.transport，在创建 mailer 时需要将 mailer.transport 作为参数传递进去。

在实际使用中，我们可以通过以下方式在代码中使用 mailer 服务：

use Symfony\Component\DependencyInjection\ContainerBuilder;
use Symfony\Component\DependencyInjection\Loader\YamlFileLoader;
use Symfony\Component\Config\FileLocator;
$containerBuilder = new ContainerBuilder();
$loader = new YamlFileLoader($containerBuilder, new FileLocator(__DIR__ . '/config'));
$loader->load('services.yaml');
$mailer = $containerBuilder->get('mailer');

通过 $containerBuilder->get('mailer') 方法，我们就可以获取到一个已经创建和配置好的 Mailer 对象。

4. 总结

依赖注入是一种广泛应用于面向对象编程中的技术，通过依赖注入，我们可以将对象之间的耦合度大大降低，从而提高了代码的可测试性和可维护性。在 Symfony 组件中，提供了一套完整的依赖注入组件，包括服务容器、组件扫描器、编译器等。通过这些组件的应用，我们可以更加方便地进行依赖对象的注册、管理和使用。