Symfony/Mailer 用于 PHP：邮件发送完整指南

\n\n

1. 这是什么以及为什么需要它

\n\n

Symfony/Mailer 是 Symfony 生态系统中一个强大且灵活的组件，用于从 PHP 应用程序发送电子邮件。与 PHP 内置的 mail() 函数（需要手动配置标头和 MIME 类型）不同，Symfony/Mailer 提供了一个面向对象的 API，用于通过不同的传输方式（SMTP、Sendmail、第三方服务 API）创建、格式化和发送消息。

\n\n

该库的主要任务是抽象邮件发送过程，使开发人员能够专注于邮件内容，而不是底层的协议细节。Symfony/Mailer 支持 HTML 模板、附件、图片嵌入、DKIM 签名，并通过 Mailer DSN（数据源名称）与流行的邮件服务集成。

\n\n

该库对于需要可靠发送事务性邮件（注册确认、密码重置、通知）、营销邮件或任何其他电子邮件通知的项目来说是不可或缺的。得益于其模块化架构，Symfony/Mailer 易于测试（通过 MockTransport）和扩展。

\n\n

2. 安装

\n\n

通过 Composer（PHP 的标准包管理器）进行安装。在项目根目录的终端中执行：

\n\n

composer require symfony/mailer

\n\n

如果您使用 Symfony Flex（推荐），安装后将自动创建配置文件 config/packages/mailer.yaml。要使用流行的邮件服务（SendGrid、Mailgun、Amazon SES 等），请安装相应的适配器，例如：

\n\n

composer require symfony/sendgrid-mailer\ncomposer require symfony/mailgun-mailer\ncomposer require symfony/amazon-mailer

\n\n

还需要 symfony/http-client 组件来使用 API 传输：

\n\n

composer require symfony/http-client

\n\n

3. 快速入门 — 最小工作示例

\n\n

安装库后，您只需几行代码即可发送第一封邮件。创建文件 send_email.php：

\n\n

<?php\n// send_email.php\nrequire_once 'vendor/autoload.php';\n\nuse Symfony\\Component\\Mailer\\Mailer;\nuse Symfony\\Component\\Mailer\\Transport\\Smtp\\EsmtpTransport;\nuse Symfony\\Component\\Mime\\Email;\n\n// 1. 创建传输（Gmail SMTP 服务器）\n$transport = new EsmtpTransport('smtp.gmail.com', 587, true);\n$transport->setUsername('your-email@gmail.com');\n$transport->setPassword('your-app-password'); // 使用应用专用密码\n\n// 2. 创建 Mailer\n$mailer = new Mailer($transport);\n\n// 3. 创建邮件\n$email = (new Email())\n    ->from('your-email@gmail.com')\n    ->to('recipient@example.com')\n    ->subject('来自 Symfony Mailer 的问候！')\n    ->text('这是一封使用 Symfony/Mailer 发送的测试邮件。')\n    ->html('<h1>你好！</h1><p>这是邮件的 <strong>HTML</strong> 版本。</p>');\n\n// 4. 发送\ntry {\n    $mailer->send($email);\n    echo "邮件发送成功！\\n";\n} catch (\\Exception $e) {\n    echo "错误：" . $e->getMessage() . "\\n";\n}

\n\n

运行脚本：

\n\n