搜索<一个target="_blank" href="https://algolia.com/?utm_source=symfony&utm_medium=link&utm_campaign=symfony_documentation">Algolia< /div>

发送邮件与梅勒

<一个类=”doc-action content-edit" href="https://github.com/symfony/symfony-docs/edit/5.4/mailer.rst"> 编辑该页面

Mime组件组成强大的系统创建和发送电子邮件,完整的支持多部分消息,树枝集成、CSS内联文件附件和更多。让他们安装:

1
美元作曲家需要symfony /梅勒欧宝娱乐app下载地址< /pre>

.env文件(<代码translate="no" class="notranslate">用户,<代码translate="no" class="notranslate">通过和<代码translate="no" class="notranslate">港口参数是可选的):

1 2
# .envMAILER_DSN = smtp: / /用户:pass@smtp.example.com:端口< /pre>
  • YAML
  • XML
  • PHP
1 2 3 4
#配置/包/ mailer.yaml框架:梅勒:dsn:' % env (MAILER_DSN) %

谨慎

如果用户名、密码或主机包含任何字符被认为是一个URI(如特殊<代码translate="no" class="notranslate">+,<代码translate="no" class="notranslate">@,<代码translate="no" class="notranslate">美元,<代码translate="no" class="notranslate">#,<代码translate="no" class="notranslate">/,<代码translate="no" class="notranslate">:,<代码translate="no" class="notranslate">*,<代码translate="no" class="notranslate">!),您必须对它们进行编码。看到<一个href=”https://www.ietf.org/rfc/rfc3986.txt" class="reference external" rel="external noopener noreferrer" target="_blank">RFC 3986保留字符或使用的完整列表<一个href=”https://secure.php.net/manual/en/function.urlencode.php" class="reference external" title="urlencode”rel="external noopener noreferrer" target="_blank">urlencode函数进行编码。

谨慎

如果你从Swiftmailer迁移(Swiftmailer包),被警告说,DSN格式是不同的。

5.2

本机协议是在Symfony 5.2中引入的。欧宝娱乐app下载地址

DSN协议 例子 描述
smtp smtp: / /用户:pass@smtp.example.com: 25< /td> 梅勒使用SMTP服务器发送电子邮件
sendmail sendmail: / /违约< /td> 梅勒使用当地sendmail二进制发送电子邮件
本机 本地:/ /违约< /td> 梅勒使用sendmail二进制和配置选项<代码translate="no" class="notranslate">sendmail_path设置<代码translate="no" class="notranslate">php . ini。在Windows主机,梅勒回退<代码translate="no" class="notranslate">smtp和<代码translate="no" class="notranslate">smtp_port<代码translate="no" class="notranslate">php . ini设置时<代码translate="no" class="notranslate">sendmail_path不是配置。

谨慎

当使用<代码translate="no" class="notranslate">本地:/ /违约,如果<代码translate="no" class="notranslate">php . ini使用<代码translate="no" class="notranslate">sendmail - t报告和命令,您不会有错误<代码translate="no" class="notranslate">Bcc头不会被删除。这是强烈建议不使用<代码translate="no" class="notranslate">本地:/ /违约当你无法控制如何sendmail配置(喜欢使用<代码translate="no" class="notranslate">sendmail: / /违约如果可能的话)。

服务 安装与
亚马逊SES 作曲家需要symfony / am欧宝娱乐app下载地址azon-mailer< /td>
MailChimp的 作曲家需要symfony / ma欧宝娱乐app下载地址ilchimp-mailer< /td>
Mailgun 作曲家需要symfony / ma欧宝娱乐app下载地址ilgun-mailer< /td>
Mailjet 作曲家需要symfony / ma欧宝娱乐app下载地址iljet-mailer< /td>
邮戳 作曲家需要symfony / po欧宝娱乐app下载地址stmark-mailer< /td>
SendGrid 作曲家需要symfony / se欧宝娱乐app下载地址ndgrid-mailer< /td>
Sendinblue 作曲家需要symfony / se欧宝娱乐app下载地址ndinblue-mailer< /td>
OhMySMTP 作曲家需要symfony / oh欧宝娱乐app下载地址-my-smtp-mailer< /td>

请注意

方便,Symfony还提供了支持Gm欧宝娱乐app下载地址ail (<代码translate="no" class="notranslate">作曲家需要symfony / go欧宝娱乐app下载地址ogle-mailer),但这在生产中不应使用。在开发中,您应该使用一个<一个href=”//www.oldmanjams.com/doc/5.4/mailer.html" class="reference internal">电子邮件捕手代替。注意,大多数支持供应商还提供了一个免费的层。

5.2

Sendinblue集成是在Symfony 5.2中引入的。欧宝娱乐app下载地址

5.4

OhMySMTP集成是在Symfony 5.4中引入的。欧宝娱乐app下载地址

每个库包含一个<一个href=”//www.oldmanjams.com/doc/5.4/setup.html" class="reference internal">欧宝娱乐app下载地址Symfony Flex食谱这将添加一个配置示例<代码translate="no" class="notranslate">.env文件。例如,假设您希望使用SendGrid。首先,安装:

1
美元作曲家需要symfony / se欧宝娱乐app下载地址ndgrid-mailer< /pre>

你现在有一个新行<代码translate="no" class="notranslate">.env文件,您可以取消:

1 2
# .envMAILER_DSN = sendgrid: / / KEY@default< /pre>

的<代码translate="no" class="notranslate">MAILER_DSN不是一个真正的地址:它是一个方便的格式,可以卸载的梅勒的配置工作。的<代码translate="no" class="notranslate">sendgrid你刚刚安装计划激活SendGrid提供者,它知道所有关于如何通过SendGrid交付消息。的只有你需要改变<代码translate="no" class="notranslate">关键占位符。

每个提供者都有不同的梅勒使用环境变量配置实际协议,交付地址和身份验证。也有一些选项,可以使用查询参数配置的<代码translate="no" class="notranslate">MAILER_DSN——就像<代码translate="no" class="notranslate">地区? =亚马逊SES或Mailgun。一些供应商支持发送通过<代码translate="no" class="notranslate">http,<代码translate="no" class="notranslate">api或<代码translate="no" class="notranslate">smtp。欧宝娱乐app下载地址Symfony选择最好的运输,但力量可以使用:

1 2 3
# .env#力使用SMTP而不是HTTP(默认)MAILER_DSN = sendgrid + smtp: / /美元SENDGRID_KEY@default< /pre>

这个表显示了可用的DSN的完整列表格式为每个第三方提供商:

提供者 SMTP HTTP API
亚马逊SES ses + smtp: / /用户名:PASSWORD@default< /td> ses + https://ACCESS_KEY SECRET_KEY@default< /td> ses + api: / / ACCESS_KEY: SECRET_KEY@default< /td>
谷歌Gmail gmail + smtp: / /用户名:PASSWORD@default< /td> n /一个 n /一个
Mailchimp的山魈 山魈+ smtp: / /用户名:PASSWORD@default< /td> 山魈+ https://KEY@default< /td> 山魈+ api: / / KEY@default< /td>
Mailgun mailgun + smtp: / /用户名:PASSWORD@default< /td> mailgun + https://KEY DOMAIN@default< /td> mailgun + api: / /关键:DOMAIN@default< /td>
Mailjet mailjet + smtp: / / ACCESS_KEY: SECRET_KEY@default< /td> n /一个 mailjet + api: / / ACCESS_KEY: SECRET_KEY@default< /td>
邮戳 邮戳+ smtp: / / ID@default< /td> n /一个 邮戳+ api: / / KEY@default< /td>
Sendgrid sendgrid + smtp: / / KEY@default< /td> n /一个 sendgrid + api: / / KEY@default< /td>
Sendinblue sendinblue + smtp: / /用户名:PASSWORD@default< /td> n /一个 sendinblue + api: / / KEY@default< /td>
OhMySMTP ohmysmtp + smtp: / / API_TOKEN@default< /td> n /一个 ohmysmtp + api: / / API_TOKEN@default< /td>

谨慎

如果您的凭据包含特殊字符,必须url。例如,DSN<代码translate="no" class="notranslate">ses + smtp: / / ABC1234:美国广播公司(abc) + 12/345@default应该配置为<代码translate="no" class="notranslate">ses + smtp: / / ABC1234: abc f345@default % 2 b12 % 2< /p>< /div>

谨慎

如果你想使用<代码translate="no" class="notranslate">ses + smtp一起运输<一个href=”//www.oldmanjams.com/doc/5.4/messenger.html" class="reference internal">信使来<一个href=”//www.oldmanjams.com/doc/5.4/mailer.html" class="reference internal">在后台发送消息,你需要添加<代码translate="no" class="notranslate">ping_threshold参数给你<代码translate="no" class="notranslate">MAILER_DSN价值低于<代码translate="no" class="notranslate">10:<代码translate="no" class="notranslate">ses + smtp: / /用户名:PASSWORD@default ? ping_threshold = 9< /p>

5.4

的<代码translate="no" class="notranslate">ping_threshold选择<代码translate="no" class="notranslate">ses-smtp是在Symfony 5.4中引入的。欧宝娱乐app下载地址

请注意

当使用SMTP发送消息的默认超时之前抛出异常是中定义的值<一个href=”https://www.php.net/manual/en/filesystem.configuration.php" class="reference external" rel="external noopener noreferrer" target="_blank">default_socket_timeoutPHP。ini选项。

5.1

的使用<代码translate="no" class="notranslate">default_socket_timeout作为默认超时是在Symfony 5.1中引入的。欧宝娱乐app下载地址

提示

如果你想覆盖默认的主机提供商(使用服务调试问题<代码translate="no" class="notranslate">requestbin.com)、变更<代码translate="no" class="notranslate">默认的您的主机:

1 2
# .envMAILER_DSN = mailgun + https://KEY: DOMAIN@requestbin.com< /pre>

注意,该协议总是HTTPs,不能更改。

高可用性通过一个叫做“切换”的技术,以确保即使一个邮件服务器发送的邮件失败。

故障转移运输与两个或两个以上的传输和配置<代码translate="no" class="notranslate">故障转移关键字:

1
MAILER_DSN =“故障转移(邮戳+ api: / / ID@default sendgrid + smtp: / / KEY@default)”

failover-transport开始使用第一个交通和如果它失败了,它将重试相同的交付下一个传输,直到其中一个成功(或失败),直到所有。

负载平衡通过一种称为“循环”的技术邮件工作负载分发到多个传输。

循环运输与两个或两个以上的传输和配置<代码translate="no" class="notranslate">设置轮流捡取关键字:

1
MAILER_DSN =此“循环(邮戳+ api: / / ID@default sendgrid + smtp: / / KEY@default)”

循环运输从一开始随机选择运输,然后切换到下一个可用的传输为每个后续邮件。

与故障转移运输、循环重试交付直到传输成功(或失败)。故障转移运输相比,它传播在所有的传输负载。

5.1

第一个随机选择的运输是在Symfony 5.1中引入的。欧宝娱乐app下载地址在之前的第一交通总是选择欧宝娱乐app下载地址Symfony版本。

verify_peer选择。虽然它不是建议禁用这个验证出于安全原因,它可能是有用的在开发应用程序或使用自签名证书时:

1
美元dsn=“smtp: / /用户:pass@smtp.example.com ? verify_peer = 0”;< /pre>

5.1

的<代码translate="no" class="notranslate">verify_peer选项是在Symfony 5.1中引入的。欧宝娱乐app下载地址

命令< /dt>

要执行的命令<代码translate="no" class="notranslate">sendmail交通:

1
美元dsn=sendmail: / /默认?命令= / usr / sbin / sendmail % 20-oi %个”

5.2

这个选项是在Symfony 5.2中引入的。欧宝娱乐app下载地址

local_domain< /dt>

域名使用<代码translate="no" class="notranslate">直升机命令:

1
美元dsn=“smtp: / / smtp.example.com ? local_domain = example.org '

5.2

这个选项是在Symfony 5.2中引入的。欧宝娱乐app下载地址

restart_threshold< /dt>

之前发送的消息的最大数量重新启动传输。它可以一起使用<代码translate="no" class="notranslate">restart_threshold_sleep:

1
美元dsn=“smtp: / / smtp.example.com ? restart_threshold = 10 &restart_threshold_sleep = 1”

5.2

这个选项是在Symfony 5.2中引入的。欧宝娱乐app下载地址

restart_threshold_sleep< /dt>

的秒数睡眠之间停止和重新启动传输。这是常见的结合起来<代码translate="no" class="notranslate">restart_threshold:

1
美元dsn=“smtp: / / smtp.example.com ? restart_threshold = 10 &restart_threshold_sleep = 1”

5.2

这个选项是在Symfony 5.2中引入的。欧宝娱乐app下载地址

ping_threshold< /dt>

最低的秒数之间的两条消息需要ping服务器:

1
美元dsn=“smtp: / / smtp.example.com ? ping_threshold = 200”

5.2

这个选项是在Symfony 5.2中引入的。欧宝娱乐app下载地址

梅勒实例的类型提示<一个href=”https://github.com/symfony/symfony/blob/5.4/src/Symfony/Component/Mailer/MailerInterface.php" class="reference external" title="MailerInterface”rel="external noopener noreferrer" target="_blank">MailerInterface并创建一个<一个href=”https://github.com/symfony/symfony/blob/5.4/src/Symfony/Component/Mime/Email.php" class="reference external" title="电子邮件”rel="external noopener noreferrer" target="_blank">电子邮件对象:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17日18 19 20 21日22日23日24日25日26日27 28 29 30
/ / src /控制器/ MailerController.php名称空间应用程序\控制器;使用欧宝娱乐app下载地址\包\FrameworkBundle\控制器\AbstractController;使用欧宝娱乐app下载地址\组件\HttpFoundation\响应;使用欧宝娱乐app下载地址\组件\梅勒\MailerInterface;使用欧宝娱乐app下载地址\组件\Mime\电子邮件;使用欧宝娱乐app下载地址\组件\路由\注释\路线;类MailerController扩展AbstractController{#(路线(' /电子邮件'))公共函数sendEmail(MailerInterface美元梅勒):响应{美元电子邮件= (新电子邮件())- >从(“hello@example.com”)- >(“you@example.com”)/ / - > cc (cc@example.com)/ / - > bcc (bcc@example.com)/ / - > replyTo (fabien@example.com)/ / - >优先(电子邮件::PRIORITY_HIGH)- >主题(“时间Symfony欧宝娱乐app下载地址梅勒!”)- >文本(“再次发送邮件很有趣!”)- >html (< p >看到树枝为更好的HTML集成一体化! < / p > ");美元梅勒- >发送(美元电子邮件);/ /……}}< /pre>

就是这样!的消息将被发送通过传输配置。如果交通配置<一个href=”//www.oldmanjams.com/doc/5.4/mailer.html" class="reference internal">异步发送邮件实际上,消息不会被发送到<一个href=”//www.oldmanjams.com/doc/5.4/messenger.html" class="reference internal">一个工人消耗它。

从(),<代码translate="no" class="notranslate">()等)接受字符串或地址对象:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20
/ /……使用欧宝娱乐app下载地址\组件\Mime\地址;美元电子邮件= (新电子邮件())/ /电子邮件地址作为一个简单的字符串- >从(“fabien@example.com”)/ /电子邮件地址作为对象- >从(新地址(“fabien@example.com”))/ /电子邮件地址和名称定义为一个对象/ /(电子邮件客户端将显示名称)- >从(新地址(“fabien@example.com”,“法”))/ /电子邮件地址和名称定义为一个字符串/ /(格式必须匹配:“名字< email@example.com >”)- >从(地址::创建(“法效力< fabien@example.com >”))/ /……;< /pre>

提示

而不是打电话<代码translate="no" class="notranslate">- >从()每一个当你创建一个新的电子邮件,你可以<一个href=”//www.oldmanjams.com/doc/5.4/mailer.html" class="reference internal">在全球范围内配置电子邮件设置相同<代码translate="no" class="notranslate">从电子邮件的所有消息。

请注意

当地的地址(前发生的一部分<代码translate="no" class="notranslate">@)可以包括utf - 8字符,除了发件人地址(以避免问题反弹的邮件)。例如:<代码translate="no" class="notranslate">foobar@example.com,<代码translate="no" class="notranslate">用户@example.com,<代码translate="no" class="notranslate">θσερ@example.com等。

5.2

支持utf - 8字符在电子邮件地址是在Symfony 5.2中引入的。欧宝娱乐app下载地址

使用<代码translate="no" class="notranslate">遭受(),<代码translate="no" class="notranslate">addCc (),或<代码translate="no" class="notranslate">addBcc ()方法来添加更多的地址:

1 2 3 4 5 6 7 8
美元电子邮件= (新电子邮件())- >(“foo@example.com”)- >遭受(“bar@example.com”)- >cc (“cc@example.com”)- >addCc (“cc2@example.com”)/ /……;< /pre>

或者,您可以将多个地址传递给每一个方法:

1 2 3 4 5 6 7 8
美元解决= (“foo@example.com”,新地址(“bar@example.com”));美元电子邮件= (新电子邮件())- >(…美元解决)- >cc (“cc1@example.com”,“cc2@example.com”)/ /……;< /pre>
               

1 2 3 4 5 6 7 8 9 10 11 12
美元电子邮件= (新电子邮件())- >getHeaders ()/ /这个非标头告诉兼容的自动回复(“电子邮件假日模式”)/ /回复此消息,因为它是一个自动电子邮件- >addTextHeader (“X-Auto-Response-Suppress”,“呕,博士,RN, NRN,自动回复的)/ /使用数组,如果你想添加一个标题,多个值/ /(例如在“引用”或“回答”头)- >addIdHeader (“引用”,(123 @example.com,456 @example.com])/ /……;< /pre>

提示

而不是打电话<代码translate="no" class="notranslate">- > addTextHeader ()每一个当你创建一个新的电子邮件,你可以<一个href=”//www.oldmanjams.com/doc/5.4/mailer.html" class="reference internal">在全球范围内配置电子邮件相同的标题设置为所有发送的邮件。

1 2 3 4 5 6 7 8 9 10
美元电子邮件= (新电子邮件())/ /……/ /简单内容定义为一个字符串- >文本(“Lorem ipsum…”)- >html (' < p > Lorem ipsum…< / p > ")/ /附加文件流- >文本(fopen (“/道路/ /电子邮件/ user_signup.txt”,“r”))- >html (fopen (“/道路/ /电子邮件/ user_signup.html”,“r”));< /pre>

提示

您还可以使用树枝模板来呈现的HTML和文本内容。读了<一个href=”//www.oldmanjams.com/doc/5.4/mailer.html" class="reference internal">枝:HTML和CSS在本文后面部分了解更多。

attachFromPath ()方法存在的附加文件在您的文件系统:

1 2 3 4 5 6 7 8
美元电子邮件= (新电子邮件())/ /……- >attachFromPath (“/道路/ /文件/ terms-of-use.pdf”)/ /可选的你可以告诉的电子邮件客户端显示一个自定义文件的名称- >attachFromPath (“/道路/ /文件/ privacy.pdf”,“隐私政策”)/ /选择您可以提供一个明确的MIME类型(否则它的猜测)- >attachFromPath (“/道路/ /文件/ contract.doc”,“合同”,“应用程序/ msword”);< /pre>

或者你可以使用<代码translate="no" class="notranslate">附加()方法从流附加内容:

1 2 3 4
美元电子邮件= (新电子邮件())/ /……- >附加(fopen (“/道路/ /文件/ contract.doc”,“r”));< /pre>

在本文的后面,图片自动嵌入。否则,您需要手动将它们嵌入。

首先,使用<代码translate="no" class="notranslate">嵌入()或<代码translate="no" class="notranslate">embedFromPath ()方法从一个文件中添加一个图像或流:

1 2 3 4 5 6 7
美元电子邮件= (新电子邮件())/ /……/ /得到一个PHP图像内容资源- >嵌入(fopen (“/道路/ /图片/ logo.png”,“r”),“标志”,“图像/ png”)/ /获取图像内容从现有的文件- >embedFromPath (“/道路/ /图片/ signature.gif”,“footer-signature”,“图像/ gif”);< /pre>

第二个可选参数的两种方法是图像名称(MIME标准的“内容识别”)。它的值是一个任意字符串使用参考图像在HTML内容:

1 2 3 4 5 6 7 8
美元电子邮件= (新电子邮件())/ /……- >嵌入(fopen (“/道路/ /图片/ logo.png”,“r”),“标志”,“图像/ png”)- >embedFromPath (“/道路/ /图片/ signature.gif”,“footer-signature”,“图像/ gif”)/ /引用图片使用语法“cid:”+“图像嵌入名称”- >html (' < img src = " cid:标志" >…< img src = " cid: footer-signature " >……”);< /pre>

- >从()在您创建的每个电子邮件,您可以配置设置这个值在全球范围内,在所有发送的邮件。也是同样如此<代码translate="no" class="notranslate">- > ()和标题。

  • YAML
  • XML
  • PHP
1 2 3 4 5 6 7 8 9 10
#配置/包/ dev / mailer.yaml框架:梅勒:信封:发送方:“fabien@example.com”收件人:(“foo@example.com”,“bar@example.com”]标题:来自:“法比< fabien@example.com >”Bcc:“baz@example.com”X-Custom-Header:“foobar”

5.2

的<代码translate="no" class="notranslate">头选项是在Symfony 5.2中引入的。欧宝娱乐app下载地址

谨慎

一些第三方供应商不支持使用关键词<代码translate="no" class="notranslate">从在<代码translate="no" class="notranslate">头。之前检查你的提供者的文档设置任何全球头。欧宝体育电话

TransportExceptionInterface。捕获该异常从错误中恢复或显示一些信息:

1 2 3 4 5 6 7 8 9 10
使用欧宝娱乐app下载地址\组件\梅勒\异常\TransportExceptionInterface;美元电子邮件=新电子邮件();/ /……试一试{美元梅勒- >发送(美元电子邮件);}抓(TransportExceptionInterface美元e){/ /一些错误阻止电子邮件发送;显示一个/ /错误消息或尝试重新发送消息}< /pre>

SentMessage返回的对象<代码translate="no" class="notranslate">send ()的方法<一个href=”https://github.com/symfony/symfony/blob/5.4/src/Symfony/Component/Mailer/Transport/TransportInterface.php" class="reference external" title="TransportInterface”rel="external noopener noreferrer" target="_blank">TransportInterface提供了访问原始消息(<代码translate="no" class="notranslate">getOriginalMessage ())和一些调试信息(<代码translate="no" class="notranslate">getDebug ())如HTTP调用通过HTTP传输,这是有用的调试错误。

请注意

梅勒提供者改变<代码translate="no" class="notranslate">问题在发送电子邮件。的<代码translate="no" class="notranslate">getMessageId ()方法从<代码translate="no" class="notranslate">SentMessage总是返回消息的确切的ID(由Symfony原始随机生成ID或新生成的ID梅勒提供者)。欧宝娱乐app下载地址

梅勒传输相关的异常(那些实现<一个href=”https://github.com/symfony/symfony/blob/5.4/src/Symfony/Component/Mailer/Exception/TransportException.php" class="reference external" title="TransportException”rel="external noopener noreferrer" target="_blank">TransportException)也通过提供这些调试信息<代码translate="no" class="notranslate">getDebug ()方法。

树枝模板引擎提供先进的特性,比如CSS样式内联和支持HTML / CSS框架来创建复杂的HTML电子邮件消息。首先,确保树枝安装:

1 2 3 4
美元作曲家需要symfony / tw欧宝娱乐app下载地址ig-bundle#如果你使用non-Symfony应用程序的组件:欧宝娱乐app下载地址#需要symfony / twig-b欧宝娱乐app下载地址ridge作曲家

TemplatedEmail类。这个类扩展了正常<一个href=”https://github.com/symfony/symfony/blob/5.4/src/Symfony/Component/Mime/Email.php" class="reference external" title="电子邮件”rel="external noopener noreferrer" target="_blank">电子邮件树枝模板类,但增加了一些新方法:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
使用欧宝娱乐app下载地址\桥\嫩枝\Mime\TemplatedEmail;美元电子邮件= (新TemplatedEmail ())- >从(“fabien@example.com”)- >(新地址(“ryan@example.com”))- >主题(“谢谢你签约!”)/ /路径的树枝模板来呈现- >htmlTemplate (“电子邮件/ signup.html.twig”)/ /变量(name = >价值)传递给模板- >上下文([“expiration_date”= >新\ DateTime (' + 7天),“用户名”= >“foo”]);< /pre>

然后,创建模板:

1 2 3 4 5 6 7 8 9 10 11 12
{/电子邮件/ signup.html #模板。树枝#}<h1>欢迎{{邮件。toName}}!< /h1><p>你签约{{username}}以下邮件:< /p><p><代码>{{email.to [0]。地址}}< /代码>< /p><p><一个href=“#”>点击这里激活您的帐户< /一个>(这个链接是有效的,直到{{expiration_date |日期(F jS)}})< /p>

树枝模板能够访问的任何参数中传递<代码translate="no" class="notranslate">上下文()的方法<代码translate="no" class="notranslate">TemplatedEmail类和一个特殊的变量<代码translate="no" class="notranslate">电子邮件的一个实例<一个href=”https://github.com/symfony/symfony/blob/5.4/src/Symfony/Bridge/Twig/Mime/WrappedTemplatedEmail.php" class="reference external" title="WrappedTemplatedEmail”rel="external noopener noreferrer" target="_blank">WrappedTemplatedEmail。

TemplatedEmail没有明确定义,梅勒将自动生成它通过将HTML内容转换为文本。如果你有<一个href=”https://github.com/thephpleague/html-to-markdown" class="reference external" rel="external noopener noreferrer" target="_blank">联盟/ html-to-markdown安装在您的应用程序,它使用HTML变成减价(所以文本电子邮件有一些视觉吸引力)。否则,它应用<一个href=”https://secure.php.net/manual/en/function.strip-tags.php" class="reference external" title="strip_tags”rel="external noopener noreferrer" target="_blank">strip_tagsPHP函数对原始HTML内容。

如果你想自己定义的文本内容,使用<代码translate="no" class="notranslate">text ()方法在前面部分或解释<代码translate="no" class="notranslate">textTemplate ()提供的方法<代码translate="no" class="notranslate">TemplatedEmail类:

1 2 3 4 5 6 7 8 9
+使用Sym欧宝娱乐app下载地址fony \桥\树枝\ Mime \ TemplatedEmail;电子邮件=美元(新TemplatedEmail ()) / /……- > htmlTemplate(邮件/ signup.html.twig)+ - > textTemplate(邮件/ signup.txt.twig)/ /……;< /pre>

< img src = " cid: " >语法解释说在前面的部分中,当使用树枝呈现邮件内容可以参考图像文件。首先,为了简化,定义一个树枝名称空间<代码translate="no" class="notranslate">图片指向任何目录存储你的照片:

  • YAML
  • XML
  • PHP
1 2 3 4 5 6 7
#配置/包/ twig.yaml枝:#……道路:这不管你的照片住#点“% kernel.project_dir % /资产/图片”:图片

现在,使用特殊的<代码translate="no" class="notranslate">email.image ()树枝助手嵌入图像内部的邮件内容:

1 2 3 4 5
{#“@images /”指的是树枝名称空间定义早些时候#}<imgsrc=”{{email.image (@images / logo.png)}}”alt=“标志”><h1>欢迎{{邮件。toName}}!< /h1>{#……#}

<时尚>…> < /风格部分,你必须内联CSS样式。

CSS内联意味着每个HTML标签必须定义一个<代码translate="no" class="notranslate">风格与所有的CSS样式属性。这可以使组织CSS一团糟。这就是为什么树枝提供<代码translate="no" class="notranslate">CssInlinerExtension自动化一切给你。安装:

1
美元作曲家需要树枝/ extra-bundle树枝/ cssinliner-extra< /pre>

扩展自动启用。使用它,包装整个模板的<代码translate="no" class="notranslate">inline_css过滤器:

1 2 3 4 5 6 7 8 9 10 11
{%应用inline_css %}<风格>{#在这里,定义你的CSS样式像往常一样#}h1{颜色:# 333;}< /风格><h1>欢迎{{邮件。toName}}!< /h1>{#……#}{%endapply%}

1 2 3 4
{%应用inline_css (源(“@styles / email.css”))%}<h1>欢迎{{username}}!< /h1>{#……#}{%endapply%}

你可以通过无限数量的参数<代码translate="no" class="notranslate">inline_css ()加载多个CSS文件。对于这个示例,您还需要定义一个新的分支名称空间<代码translate="no" class="notranslate">风格指向的目录<代码translate="no" class="notranslate">email.css生命:

  • YAML
  • XML
  • PHP
1 2 3 4 5 6 7
#配置/包/ twig.yaml枝:#……道路:#点这不管你的css文件“% kernel.project_dir % /资产/风格”:风格

MarkdownExtension这允许您定义使用电子邮件内容<一个href=”https://commonmark.org/" class="reference external" rel="external noopener noreferrer" target="_blank">减记语法。使用这个,安装扩展和减价转换库(扩展兼容几个流行的库):

1 2
#不是联盟/ commonmark之外,您还可以使用erusev / parsedown或michelf / php-markdown美元作曲家需要树枝/ extra-bundle树枝/ markdown-extra联盟/ commonmark< /pre>

扩展添加一个<代码translate="no" class="notranslate">markdown_to_html过滤器,您可以使用转换部分或整个从减价到HTML电子邮件内容:

1 2 3 4 5 6 7 8 9
{%应用markdown_to_html %}欢迎{{邮件。toName}}!= = = = = = = = = = = = = = = = = = = = = = = = = = =你注册我们的网站使用下面的电子邮件:“{{email.to [0]。地址}}(点击这里激活您的帐户)({{url (“…”)}}){%endapply%}

漆黑的。它定义了一个语法基于一些类似HTML的标记,后来变成了真正的HTML代码发送给用户:

1 2 3 4 5 6
< !漆黑的语法的一个简化的例子——><容器><行><列>这是一个列。< /列>< /行>< /容器>

嫩枝为集成提供了漆黑的通过<代码translate="no" class="notranslate">InkyExtension。首先,在应用程序中安装扩展:

1
美元作曲家需要树枝/ extra-bundle树枝/ inky-extra< /pre>

扩展添加一个<代码translate="no" class="notranslate">inky_to_html过滤器,它可以用来从漆黑的部分或整个邮件内容转换为HTML:

1 2 3 4 5 6 7 8 9 10 11 12
{%应用inky_to_html %}<容器><行类=“头”><列><垫片大小=“16”>< /垫片><h1类=“text-center”>欢迎{{邮件。toName}}!< /h1>< /列>{#……#}< /行>< /容器>{%endapply%}

您可以将所有的过滤器来创建复杂的邮件:

1 2 3
{%应用inky_to_html |inline_css(源(“@styles / foundation-emails.css”))%}{#……#}{%endapply%}

这使得使用<一个href=”//www.oldmanjams.com/doc/5.4/mailer.html" class="reference internal">风格树枝名称空间我们之前创建。例如,你可以<一个href=”https://github.com/foundation/foundation-emails/blob/develop/dist/foundation-emails.css" class="reference external" rel="external noopener noreferrer" target="_blank">下载foundation-emails。css文件直接从GitHub并保存它<代码translate="no" class="notranslate">资产/风格。

OpenSSL PHP扩展正确安装和配置;
  • 一个有效的<一个href=”https://en.wikipedia.org/wiki/S/MIME" class="reference external" rel="external noopener noreferrer" target="_blank">S / MIME安全证书。

    • 提示

    当使用OpenSSL来生成证书,确保添加<代码translate="no" class="notranslate">-addtrust emailProtection命令选项。

    S / MIME或<代码translate="no" class="notranslate">DKIM。在这两种情况下,证书和私钥必须<一个href=”https://en.wikipedia.org/wiki/Privacy-Enhanced_Mail" class="reference external" rel="external noopener noreferrer" target="_blank">PEM编码,可以使用例如OpenSSL创建或获取官方证书颁发机构(CA)。电子邮件收件人必须CA证书列表中的受信任的发行者为了验证签名。

    S / MIME是一个标准的MIME的公钥加密和签名数据。它需要使用证书和私钥:

    1 2 3 4 5 6 7 8 9 10 11 12 13 14
    使用欧宝娱乐app下载地址\组件\Mime\加密\SMimeSigner;使用欧宝娱乐app下载地址\组件\Mime\电子邮件;美元电子邮件= (新电子邮件())- >从(“hello@example.com”)/ /……- >html (“……”);美元签名者=新SMimeSigner (“/道路/ / certificate.crt”,“/道路/ / certificate-private-key.key”);/ /如果私钥密码,通过它作为第三个参数/ /新SMimeSigner(' /道路/ /证书。crt’、‘/路径/ / certificate-private-key。关键”、“口令”);美元signedEmail=美元签名者- >号(美元电子邮件);/ /现在使用梅勒组件发送美元signedEmail代替原来的电子邮件

    提示

    的<代码translate="no" class="notranslate">SMimeSigner类定义了其他可选参数通过中级证书和配置签名过程使用位操作符选项<一个href=”https://secure.php.net/manual/en/function.openssl-pkcs7-sign.php" class="reference external" title="openssl_pkcs7_sign”rel="external noopener noreferrer" target="_blank">openssl_pkcs7_signPHP函数。

    DKIM是一个电子邮件词缀数字签名认证方法,与一个域名,每个即将离任的电子邮件消息。它需要一个私人密钥而不是证书:

    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17日18 19 20 21日22日23日24日25日26日27日28
    使用欧宝娱乐app下载地址\组件\Mime\加密\DkimSigner;使用欧宝娱乐app下载地址\组件\Mime\电子邮件;美元电子邮件= (新电子邮件())- >从(“hello@example.com”)/ /……- >html (“……”);/ /第一个参数:openssl_pkey_get_private一样(),一个字符串的/ /私有密钥的内容或绝对路径(前缀的文件:/ /)/ /第二个和第三个参数:域名和“选择器”用来执行DNS查找/ /(选择器是一个字符串用于指向一个特定DKIM公钥在您的DNS记录)美元签名者=新DkimSigner (的文件:/ / /道路/ / private-key.key ',“example.com”,“科幻小说”);/ /如果私钥密码,把它作为第五个参数/ /新DkimSigner(“文件:/ / /道路/ /私有密匙。关键”、“example.com”、“科幻小说”,[],“口令”);美元signedEmail=美元签名者- >号(美元电子邮件);/ /现在使用梅勒组件发送美元signedEmail代替原来的电子邮件/ / DKIM签名者提供了许多配置选项和一个辅助对象来配置它们使用欧宝娱乐app下载地址\组件\Mime\加密\DkimOptions;美元signedEmail=美元签名者- >号(美元电子邮件,(新DkimOptions ())- >bodyCanon (“放松”)- >headerCanon (“放松”)- >headersToIgnore ([“问题”])- >toArray ());< /pre>

    5.2

    在Symfony 5.2中介绍了DKIM签名者。欧宝娱乐app下载地址

    1 2 3 4 5 6 7 8 9 10 11
    使用欧宝娱乐app下载地址\组件\Mime\加密\SMimeEncrypter;使用欧宝娱乐app下载地址\组件\Mime\电子邮件;美元电子邮件= (新电子邮件())- >从(“hello@example.com”)/ /……- >html (“……”);美元加密=新SMimeEncrypter (“/道路/ / certificate.crt”);美元encryptedEmail=美元加密- >加密(美元电子邮件);/ /现在使用梅勒组件发送美元encryptedEmail代替原来的电子邮件

    你可以通过多个证书<代码translate="no" class="notranslate">SMimeEncrypter构造函数,它会根据选择适当的证书<代码translate="no" class="notranslate">来选择:

    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18
    美元firstEmail= (新电子邮件())/ /……- >(“jane@example.com”);美元secondEmail= (新电子邮件())/ /……- >(“john@example.com”);/ /第二个可选参数SMimeEncrypter定义使用哪种加密算法/ /(一定是其中的一个常量:https://www.php.net/manual/en/openssl.ciphers.php)美元加密=新SMimeEncrypter ([/ /关键=电子邮件收件人;值=证书文件路径“jane@example.com”= >“/道路/ / first-certificate.crt”,“john@example.com”= >“/道路/ / second-certificate.crt”]);美元firstEncryptedEmail=美元加密- >加密(美元firstEmail);美元secondEncryptedEmail=美元加密- >加密(美元secondEmail);< /pre>

    dsn配置项的<代码translate="no" class="notranslate">传输条目,如:

    • YAML
    • XML
    • PHP
    1 2 3 4 5 6
    #配置/包/ mailer.yaml框架:梅勒:传输:主要:' % env (MAILER_DSN) %选择:' % env (MAILER_DSN_IMPORTANT) %

    在默认情况下使用第一运输。通过添加一个可以选择其他的传输<代码translate="no" class="notranslate">X-Transport头(梅勒从最后的邮件将自动删除):

    1 2 3 4 5 6
    / /发送使用第一传输(“主要”):美元梅勒- >发送(美元电子邮件);/ /……或使用传输“另类”:美元电子邮件- >getHeaders ()- >addTextHeader (“X-Transport”,“替代”);美元梅勒- >发送(美元电子邮件);< /pre>

    (梅勒- >发送美元电子邮件)立即,电子邮件被发送到运输。为了提高性能,您可以利用<一个href=”//www.oldmanjams.com/doc/5.4/messenger.html" class="reference internal">信使发送消息后通过信使运输。

    开始后,<一个href=”//www.oldmanjams.com/doc/5.4/messenger.html" class="reference internal">信使欧宝体育电话文档和配置一个交通工具。一旦一切都设置,当你调用<代码translate="no" class="notranslate">梅勒- >发送(),一个<一个href=”https://github.com/symfony/symfony/blob/5.4/src/Symfony/Component/Mailer/Messenger/SendEmailMessage.php" class="reference external" title="SendEmailMessage”rel="external noopener noreferrer" target="_blank">SendEmailMessage消息将被派遣到缺省消息总线(<代码translate="no" class="notranslate">messenger.default_bus)。假设你有一个运输<代码translate="no" class="notranslate">异步,你可以将消息路由:

    • YAML
    • XML
    • PHP
    1 2 3 4 5 6 7 8
    #配置/包/ messenger.yaml框架:信使:传输:异步:“% env (MESSENGER_TRANSPORT_DSN) %”路由:“欧宝娱乐app下载地址Symfony \组件\梅勒\ \ SendEmailMessage使者’:异步

    由于这一点,而不是立即交付,消息将被发送到运输处理后(参见<一个href=”//www.oldmanjams.com/doc/5.4/messenger.html" class="reference internal">信使:同步和排队消息处理)。

    您可以配置总线是用于分派消息使用<代码translate="no" class="notranslate">message_bus选择。你也可以设置<代码translate="no" class="notranslate">假直接调用梅勒运输和禁用异步交付。

    • YAML
    • XML
    • PHP
    1 2 3 4
    #配置/包/ mailer.yaml框架:梅勒:message_bus:app.another_bus

    5.1

    的<代码translate="no" class="notranslate">message_bus选项是在Symfony 5.1中引入的。欧宝娱乐app下载地址

    5.1

    的<一个href=”https://github.com/symfony/symfony/blob/5.4/src/Symfony/Component/Mailer/Header/TagHeader.php" class="reference external" title="TagHeader”rel="external noopener noreferrer" target="_blank">TagHeader和<一个href=”https://github.com/symfony/symfony/blob/5.4/src/Symfony/Component/Mailer/Header/MetadataHeader.php" class="reference external" title="MetadataHeader”rel="external noopener noreferrer" target="_blank">MetadataHeader类是在Symfony 5.1中引入的。欧宝娱乐app下载地址

    某些第三方传输电子邮件支持标签和元数据可用于分组,跟踪和工作流。您可以添加使用<一个href=”https://github.com/symfony/symfony/blob/5.4/src/Symfony/Component/Mailer/Header/TagHeader.php" class="reference external" title="TagHeader”rel="external noopener noreferrer" target="_blank">TagHeader和<一个href=”https://github.com/symfony/symfony/blob/5.4/src/Symfony/Component/Mailer/Header/MetadataHeader.php" class="reference external" title="MetadataHeader”rel="external noopener noreferrer" target="_blank">MetadataHeader类。如果您的运输支持头,它会将它们转换为适当的格式:

    1 2 3 4 5 6
    使用欧宝娱乐app下载地址\组件\梅勒\头\MetadataHeader;使用欧宝娱乐app下载地址\组件\梅勒\头\TagHeader;美元电子邮件- >getHeaders ()- >add (新TagHeader (“密码重置”));美元电子邮件- >getHeaders ()- >add (新MetadataHeader (“颜色”,“蓝”));美元电子邮件- >getHeaders ()- >add (新MetadataHeader (“客户机id”,“12345”));< /pre>

    如果你交通不支持标签和元数据,它们将被添加自定义标题:

    1 2 3
    X-Tag:密码重置X-Metadata-Color:蓝色X-Metadata-Client-ID: 12345< /pre>

    目前支持以下传输标签和元数据:

    • MailChimp的
    • Mailgun
    • 邮戳
    • Sendgrid
    • Sendinblue

    5.4

    标签和元数据支持Sendgrid是在Symfony 5.4中引入的。欧宝娱乐app下载地址

    以下传输只支持标签:

    • OhMySMTP

    MessageEvent允许改变之前的消息和信封发送电子邮件:

    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21日22日23日
    使用欧宝娱乐app下载地址\组件\EventDispatcher\EventSubscriberInterface;使用欧宝娱乐app下载地址\组件\梅勒\事件\MessageEvent;使用欧宝娱乐app下载地址\组件\Mime\电子邮件;类MailerSubscriber实现了EventSubscriberInterface{公共静态函数getSubscribedEvents(){返回[MessageEvent::类= >“onMessage”,);}公共函数onMessage(MessageEvent美元事件):无效{美元消息=美元事件- >getMessage ();如果(!美元消息运算符电子邮件){返回;}/ /做一些消息}}< /pre>

    提示

    当使用一个<代码translate="no" class="notranslate">MessageEvent侦听器<一个href=”//www.oldmanjams.com/doc/5.4/mailer.html" class="reference internal">标志的邮件内容尽可能晚地,运行它(例如,设置一个消极的优先级)的邮件内容没有设置或修改后签字。

    欧宝娱乐app下载地址Symfony本地web服务器梅勒DSN自动通过<一个href=”//www.oldmanjams.com/doc/5.4/setup/symfony_server.html" class="reference internal">欧宝娱乐app下载地址symfony二进制码头工人集成。

    空:/ / null梅勒DSN,要么在你<一个href=”//www.oldmanjams.com/doc/5.4/configuration.html" class="reference internal">.env配置文件或在梅勒配置文件(例如<代码translate="no" class="notranslate">dev或<代码translate="no" class="notranslate">测试环境):

    • YAML
    • XML
    • PHP
    1 2 3 4
    #配置/包/ dev / mailer.yaml框架:梅勒:dsn:“零:/ /空”

    请注意

    如果你使用信使和路由传输,消息仍然被发送到运输。

    • YAML
    • XML
    • PHP
    1 2 3 4 5
    #配置/包/ dev / mailer.yaml框架:梅勒:信封:收件人:(“youremail@example.com”)

    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21日22日23日24
    / /测试/控制器/ MailControllerTest.php名称空间应用程序\测试\控制器;使用欧宝娱乐app下载地址\包\FrameworkBundle\测试\MailerAssertionsTrait;使用欧宝娱乐app下载地址\包\FrameworkBundle\测试\WebTestCase;类MailControllerTest扩展WebTestCase{使用MailerAssertionsTrait;公共函数testMailIsSentAndContentIsOk(){美元客户端=美元这- >createClient ();美元客户端- >请求(“得到”,/邮件/发送的);美元这- >assertResponseIsSuccessful ();美元这- >assertEmailCount (1);美元电子邮件=美元这- >getMailerMessage ();美元这- >assertEmailHtmlBodyContains (美元电子邮件,“欢迎”);美元这- >assertEmailTextBodyContains (美元电子邮件,“欢迎”);}}< /pre>

    这项工作,包括代码示例,许可下<一个rel="license" href="https://creativecommons.org/licenses/by-sa/3.0/">Creative Commons冲锋队3.0许可证。
    欧宝娱乐app下载地址Symfony 5.4是<一个href=”//www.oldmanjams.com/backers">支持通过<一个类=”link stretched-link" href="https://packagist.com/">私人Packagist。
    在线考试,成为今天Symfony认证欧宝娱乐app下载地址”>< /一个><p类=”highlight-symfony-text在线考试,成为今天Symfony认证欧宝娱乐app下载地址< /p>< /div>
    同步你的应用数据和服务”>< /一个><p类=”highlight-symfony-text同步你的应用数据和服务< /p>< /div>
    代码消耗服务器资源。黑焰告诉你”>< /一个><p类=”highlight-symfony-text代码消耗服务器资源。黑焰告诉你< /p>< /div>