Swiftmailer Bundle 使用详解

1. 安装指南

由于Swiftmailer自2021年11月起已不再维护，因此建议您尽快迁移到Symfony Mailer。以下是迁移至Symfony Mailer的安装步骤：

首先，确保你的环境中已经安装了Composer。然后，运行以下命令安装Symfony Mailer：

composer require symfony/mailer

接下来，在config/packages/mailer.yaml文件中配置Mailer的DSN（数据源名称）：

framework:
    mailer:
        dsn: '%env(MAILER_DSN)%'

确保你的.env文件中设置了正确的MAILER_DSN环境变量。

2. 项目使用说明

Swiftmailer Bundle是用来发送电子邮件的，但由于其不再维护，我们推荐使用Symfony Mailer。以下是Symfony Mailer的基本使用说明：

发送邮件

使用Symfony Mailer发送邮件非常简单。首先，创建一个邮件实例：

use Symfony\Component\Mailer\Mailer;
use Symfony\Component\Mime\Email;

$mailer = new Mailer(/* 你的transport */);

$email = (new Email())
    ->from('[e-mail]')
    ->to('[e-mail]')
    ->subject('Time for Symfony Mailer!')
    ->text('This is the body of the email.')
    ->html('<h1>This is the HTML body of the email.</h1>');

$mailer->send($email);

集成第三方服务

Symfony Mailer支持多种第三方邮件服务提供商。例如，使用SendGrid发送邮件，你需要先安装相应的依赖：

composer require symfony/sendgrid-mailer

然后在.env文件中配置SendGrid的DSN：

MAILER_DSN=sendgrid://KEY@default

替换KEY为你的SendGrid API密钥。

3. 项目API使用文档

Symfony Mailer提供了一系列API用于发送和管理邮件。以下是几个常用的API：

发送邮件

如上所述，使用Mailer类和Email类来创建并发送邮件。

管理附件

你可以向邮件中添加附件：

$email->attachFromPath('/path/to/file.jpg');

使用模板

Symfony Mailer支持使用Twig模板：

use Twig\Environment;

// ...
twig->render('email template.html.twig', ['name' => 'Fabien']);

确保你已经安装了Twig并正确配置。

4. 项目安装方式

由于Swiftmailer Bundle不再维护，我们推荐通过以下方式安装Symfony Mailer：

composer require symfony/mailer

安装完成后，按照上文提到的配置Mailer的DSN，并开始使用它发送邮件。

请确保遵循Symfony Mailer的官方文档以获取更多详细信息和高级用法。