搜索<一个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/4.4/mailer.rst"> 编辑该页面

警告:你浏览的文档欧宝体育电话<一个href=”//www.oldmanjams.com/releases/4.4">欧宝娱乐app下载地址Symfony 4.4,不再维护。

读<一个href=”//www.oldmanjams.com/doc/current/mailer.html">这个页面的更新版本Symf欧宝娱乐app下载地址ony 6.2(当前的稳定版本)。

4.3

梅勒组件是在Symfony 4.3中引入的,迅速取代了梅勒。欧宝娱乐app下载地址

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格式是不同的。

DSN协议 例子 描述
smtp smtp: / /用户:pass@smtp.example.com: 25< /td> 梅勒使用SMTP服务器发送电子邮件
sendmail sendmail: / /违约< /td> 梅勒使用当地sendmail二进制发送电子邮件

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

每个库包含一个<一个href=”//www.oldmanjams.com/doc/4.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>
邮戳 邮戳+ smtp: / / ID@default< /td> n /一个 邮戳+ api: / / KEY@default< /td>
Sendgrid sendgrid + smtp: / / KEY@default< /td> n /一个 sendgrid + api: / / KEY@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>

谨慎

欧宝娱乐app下载地址Symfony 4.4仅支持亚马逊SES签名版本3已弃用。您需要使用<代码translate="no" class="notranslate">欧宝娱乐app下载地址symfony / amazon-mailer5.1或更新的版本。

提示

如果你想覆盖默认的主机提供商(使用服务调试问题<代码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)”

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

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

梅勒实例的类型提示<一个href=”https://github.com/symfony/symfony/blob/4.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/4.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 31 32
/ / src /控制器/ MailerController.php名称空间应用程序\控制器;使用欧宝娱乐app下载地址\包\FrameworkBundle\控制器\AbstractController;使用欧宝娱乐app下载地址\组件\HttpFoundation\响应;使用欧宝娱乐app下载地址\组件\梅勒\MailerInterface;使用欧宝娱乐app下载地址\组件\Mime\电子邮件;使用欧宝娱乐app下载地址\组件\路由\注释\路线;类MailerController扩展AbstractController{/ * * *@Route(" /电子邮件”)* /公共函数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>

就是这样!的消息将被发送通过传输配置。

从(),<代码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 >”)- >从(地址::fromString (“法效力< fabien@example.com >”))/ /……;< /pre>

提示

而不是打电话<代码translate="no" class="notranslate">- >从()每一个当你创建一个新的电子邮件,您可以创建一个<一个href=”//www.oldmanjams.com/doc/4.4/event_dispatcher.html" class="reference internal">事件订阅者和听<一个href=”https://github.com/symfony/symfony/blob/4.4/src/Symfony/Component/Mailer/Event/MessageEvent.php" class="reference external" title="MessageEvent”rel="external noopener noreferrer" target="_blank">MessageEvent事件设置相同<代码translate="no" class="notranslate">从电子邮件的所有消息。

使用<代码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>
               

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/4.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>

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/4.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下载地址

4.4

的<代码translate="no" class="notranslate">getMessageId ()方法是在Symfony 4.4中引入的。欧宝娱乐app下载地址

梅勒传输相关的异常(那些实现<一个href=”https://github.com/symfony/symfony/blob/4.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 ()方法。

4.4

的<代码translate="no" class="notranslate">getDebug ()方法在Symfony 4.4中引入的。欧宝娱乐app下载地址

树枝模板引擎提供先进的特性,比如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/4.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/4.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 (源(“@css / email.css”))%}<h1>欢迎{{username}}!< /h1>{#……#}{%endapply%}

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

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

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(源(“@css / foundation-emails.css”))%}{#……#}{%endapply%}

这使得使用<一个href=”//www.oldmanjams.com/doc/4.4/mailer.html" class="reference internal">css树枝名称空间我们之前创建。例如,你可以<一个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">资产/ css。

4.4

选择签署和/或加密消息是在Symfony 4.4中引入的。欧宝娱乐app下载地址

有可能签署和/或加密电子邮件应用<一个href=”https://en.wikipedia.org/wiki/S/MIME" class="reference external" rel="external noopener noreferrer" target="_blank">S / MIME增加他们的完整性/安全标准。这两种选择都可以组合加密签名消息和/或签署一个加密的消息。

签名/加密消息之前,确保有:

  • 的<一个href=”https://www.php.net/manual/en/book.openssl.php" class="reference external" rel="external noopener noreferrer" target="_blank">OpenSSL PHP扩展正确安装和配置;
  • 一个有效的<一个href=”https://en.wikipedia.org/wiki/S/MIME" class="reference external" rel="external noopener noreferrer" target="_blank">S / 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代替原来的电子邮件

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

提示

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

提示

的<代码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函数。

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>

4.4

可以定义多个电子邮件传输是在Symfony 4.4中引入的。欧宝娱乐app下载地址

你可能想要使用多个梅勒运输交付你的消息。这可以通过替换配置<代码translate="no" class="notranslate">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/4.4/messenger.html" class="reference internal">信使发送消息后通过信使运输。

开始后,<一个href=”//www.oldmanjams.com/doc/4.4/messenger.html" class="reference internal">信使欧宝体育电话文档和配置一个交通工具。一旦一切都设置,当你调用<代码translate="no" class="notranslate">梅勒- >发送(),一个<一个href=”https://github.com/symfony/symfony/blob/4.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/4.4/messenger.html" class="reference internal">信使:同步和排队消息处理)。

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/4.4/mailer.html" class="reference internal">标志的邮件内容尽可能晚地,运行它(例如,设置一个消极的优先级)的邮件内容没有设置或修改后签字。

空:/ / null梅勒DSN,要么在你<一个href=”//www.oldmanjams.com/doc/4.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许可证。
确保你的项目是无风险的”>< /一个><p类=”highlight-symfony-text确保你的项目是无风险的< /p>< /div>
加快你的Symfony部署欧宝娱乐app下载地址”>< /一个><p类=”highlight-symfony-text加快你的Symfony部署欧宝娱乐app下载地址< /p>< /div>
欧宝娱乐app下载地址Symfony代码性能”>< /一个><p类=”highlight-symfony-text欧宝娱乐app下载地址Symfony代码性能< /p>< /div>