如何在TYPO3中覆盖表单系统扩展完成器以添加多邮箱地址？

嘿，这个问题我之前帮不少开发者解决过——TYPO3默认的表单完成器对收件人格式的校验确实卡得很严，直接用逗号分隔多个邮箱就会触发那个RFC格式异常。别担心，给你几个靠谱的解决方案，从快速实现到灵活定制都有：

方案一：自定义表单完成器（最灵活，推荐） #

这个方法完全自定义收件人的解析逻辑，能完美支持任意数量的邮箱地址，步骤也不复杂：

1. 创建自定义完成器类
   在你的站点包（Site Package）里新建一个完成器类，继承默认的EmailToReceiverFinisher，重写收件人解析方法：

<?php
namespace Vendor\SitePackage\Finishers;

use TYPO3\CMS\Form\Domain\Finishers\EmailToReceiverFinisher;
use TYPO3\CMS\Core\Utility\GeneralUtility;

class MultiRecipientEmailFinisher extends EmailToReceiverFinisher
{
    protected function parseRecipients(string $recipientString): array
    {
        $recipients = [];
        // 拆分逗号分隔的邮箱，自动过滤空格和无效地址
        foreach (GeneralUtility::trimExplode(',', $recipientString, true) as $email) {
            if (filter_var($email, FILTER_VALIDATE_EMAIL)) {
                $recipients[] = ['email' => $email];
            }
        }
        return $recipients;
    }
}

2. 注册自定义完成器
   在站点包的Configuration/Services.yaml里注册这个完成器：

services:
  Vendor\SitePackage\Finishers\MultiRecipientEmailFinisher:
    tags:
      - name: form.finisher
        identifier: 'MultiRecipientEmail'

3. 在表单配置中使用
   修改你的表单yaml配置，把原来的EmailToReceiver替换成自定义的完成器，直接用逗号分隔多个收件人：

finishers:
  -
    identifier: 'MultiRecipientEmail'
    options:
      recipientAddress: 'mail1@example.de, mail2@example.de, mail3@example.de'
      senderAddress: 'your-sender@example.de'
      subject: '新的表单提交通知'
      # 其他原有选项保持不变

记得一定要清理TYPO3缓存，否则新的完成器不会生效！

方案二：用抄送/密送批量添加（快速实现） #

如果不想写代码，也可以把额外收件人放到cc（抄送）或bcc（密送）字段里，同样用逗号分隔。不过要注意：

• 确保每个邮箱格式正确，避免无效地址
• 这种方式适合收件人数量不多的场景，如果你需要区分主收件人和抄送人，这个方法很合适

示例配置：

finishers:
  -
    identifier: 'EmailToReceiver'
    options:
      recipientAddress: 'primary@example.de'
      carbonCopyAddress: 'mail2@example.de, mail3@example.de'
      # 或者用密送：blindCarbonCopyAddress: 'mail2@example.de, mail3@example.de'
      senderAddress: 'your-sender@example.de'

方案三：用信号/槽修改邮件收件人（无侵入式） #

如果你不想修改完成器本身，可以通过监听表单的BeforeSendMailEvent信号，在邮件发送前动态添加收件人：

1. 创建信号槽类

<?php
namespace Vendor\SitePackage\Slot;

use TYPO3\CMS\Form\Domain\Finishers\Event\BeforeSendMailEvent;
use TYPO3\CMS\Core\Utility\GeneralUtility;

class ModifyEmailRecipientsSlot
{
    public function __invoke(BeforeSendMailEvent $event): void
    {
        $mail = $event->getMail();
        $formRuntime = $event->getFormRuntime();
        
        // 从完成器配置中获取额外收件人
        $finishers = $formRuntime->getFormDefinition()->getFinishers();
        foreach ($finishers as $finisher) {
            if ($finisher->getIdentifier() === 'EmailToReceiver') {
                $additionalRecipients = $finisher->getOption('additionalRecipientAddresses');
                if ($additionalRecipients) {
                    foreach (GeneralUtility::trimExplode(',', $additionalRecipients, true) as $email) {
                        if (filter_var($email, FILTER_VALIDATE_EMAIL)) {
                            $mail->addTo($email);
                        }
                    }
                }
            }
        }
        
        $event->setMail($mail);
    }
}

2. 注册信号槽
   在Configuration/Services.yaml里添加：

services:
  Vendor\SitePackage\Slot\ModifyEmailRecipientsSlot:
    tags:
      - name: event.listener
        identifier: 'modify-email-recipients'
        event: TYPO3\CMS\Form\Domain\Finishers\Event\BeforeSendMailEvent

3. 更新表单配置
   给完成器添加自定义选项additionalRecipientAddresses：

finishers:
  -
    identifier: 'EmailToReceiver'
    options:
      recipientAddress: 'mail1@example.de'
      additionalRecipientAddresses: 'mail2@example.de, mail3@example.de'
      senderAddress: 'your-sender@example.de'

注意事项 #

• 所有邮箱地址必须符合RFC 2822格式，否则会被过滤（或者你可以根据需求调整校验逻辑）
• 自定义代码后一定要清理TYPO3的系统缓存
• 如果是多站点场景，记得确保站点包的配置正确加载

内容的提问来源于stack exchange，提问作者MonTea