Symfony装饰器怎么用_Symfony服务装饰方法【详解】-php教程-PHP中文网

Symfony服务装饰器通过实现相同接口包裹原始服务以增强行为，需在services.yaml中配置decorates和decoration_inner_name，并在装饰器类中委托调用原始服务。

symfony装饰器怎么用_symfony服务装饰方法【详解】

Symfony服务装饰器（Decorator）用于在不改动原始服务代码的前提下，增强或修改其行为。它不是替换服务，而是“包裹”它，形成链式调用——请求先进入装饰器，再转发给被装饰的服务，最后可对结果或过程做额外处理。

明确接口与实现关系

装饰器必须和被装饰服务实现**同一接口**，否则类型注入会失败。例如你要装饰 MailerInterface，你的装饰器类就得 implements MailerInterface。这是类型安全的基础，也是自动装配能正常工作的前提。

没有接口？建议先提取接口，避免直接装饰具体类（违反开闭原则）
若必须装饰无接口的类，需确保构造函数参数类型与原始服务一致，并在 YAML 中显式声明 public: false 防止冲突

在 services.yaml 中配置装饰器

核心是 decorates 键，它指定要包裹哪个服务 ID。同时推荐设置 decoration_inner_name，方便在装饰器内部获取原始服务实例：

Symfony Linux版

Symfony Linux版整理 Symfony CLI 5.17.1 官方下载入口和 Symfony 框架安装配置说明。

下载

App\Service\LoggingMailer:
  decorates: 'mailer'
  decoration_inner_name: 'decorated_mailer.inner'
  arguments:
    - '@decorated_mailer.inner'
    - '@logger'

decorates: 'mailer' 表示该服务将替代容器中 ID 为 mailer 的服务
decoration_inner_name 是 Symfony 自动生成的别名，指向原始 mailer 实例
arguments 中通过 @decorated_mailer.inner 注入原始服务，实现委托调用

编写装饰器类（委托+扩展）

装饰器类本身不承担核心逻辑，只负责“拦截→增强→转发”。典型结构如下：

namespace App\Service;
<p>use Symfony\Component\Mailer\MailerInterface;
use Psr\Log\LoggerInterface;</p><p>class LoggingMailer implements MailerInterface
{
private MailerInterface $decorated;
private LoggerInterface $logger;</p><pre class="brush:php;toolbar:false;">public function __construct(MailerInterface $decorated, LoggerInterface $logger)
{
    $this->decorated = $decorated;
    $this->logger = $logger;
}

public function send(\Symfony\Component\Mime\Email $email, ?\Symfony\Component\Mime\Address $envelopeSender = null): void
{
    $this->logger->info('Sending email to {to}', ['to' => $email->getTo()[0]->getAddress()]);
    $this->decorated->send($email, $envelopeSender); // 委托执行
}

}