Symfony Mailer多传输配置与高级使用指南

# config/packages/mailer.yaml
framework:
    mailer:
        # 默认传输，如果没有指定X-Transport头，将使用此传输
        transports:
            main: '%env(MAILER_DSN_DEFAULT)%'
            # 备用传输，可用于发送重要邮件或作为主传输的备份
            alternative: '%env(MAILER_DSN_IMPORTANT)%'
            # 另一个传输，例如用于发送营销邮件
            marketing: '%env(MAILER_DSN_MARKETING)%'

# .env
MAILER_DSN_DEFAULT="smtp://user:pass@smtp.example.com:587"
MAILER_DSN_IMPORTANT="smtp://user2:pass2@smtp.another-example.com:465"
MAILER_DSN_MARKETING="sendgrid://SG.your_api_key@default"

<?php

namespace App\Controller;

use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Mailer\MailerInterface;
use Symfony\Component\Mime\Email;
use Symfony\Component\Routing\Annotation\Route;

class MailerController extends AbstractController
{
    /**
     * @Route("/send-email", name="send_email")
     */
    public function sendEmail(MailerInterface $mailer): Response
    {
        // 1. 使用默认传输（即 'main'）发送邮件
        $emailDefault = (new Email())
            ->from('sender@example.com')
            ->to('recipient@example.com')
            ->subject('默认传输测试邮件')
            ->text('这是一封通过默认传输发送的邮件。');

        $mailer->send($emailDefault);
        $this->addFlash('success', '邮件已通过默认传输发送！');

        // 2. 使用 'alternative' 传输发送邮件
        $emailAlternative = (new Email())
            ->from('important@example.com')
            ->to('critical_recipient@example.com')
            ->subject('重要通知 - 通过备用传输')
            ->text('这是一封通过备用传输发送的重要邮件。');

        // 添加 X-Transport 头，指定使用 'alternative' 传输
        $emailAlternative->getHeaders()->addTextHeader('X-Transport', 'alternative');
        $mailer->send($emailAlternative);
        $this->addFlash('success', '重要邮件已通过备用传输发送！');

        // 3. 使用 'marketing' 传输发送邮件
        $emailMarketing = (new Email())
            ->from('newsletter@example.com')
            ->to('subscriber@example.com')
            ->subject('最新资讯 - 通过营销传输')
            ->html('<p>这是一封通过营销传输发送的<b>HTML</b>邮件。</p>');

        // 添加 X-Transport 头，指定使用 'marketing' 传输
        $emailMarketing->getHeaders()->addTextHeader('X-Transport', 'marketing');
        $mailer->send($emailMarketing);
        $this->addFlash('success', '营销邮件已通过营销传输发送！');

        return $this->render('mailer/index.html.twig', [
            'message' => '所有测试邮件已尝试发送。',
        ]);
    }
}