CMS后端Web框架【免费下载链接】OrchardCoreOrchard Core is an open-source modular and multi-tenant application framework built with ASP.NET Core, and a content management system (CMS) built on top of that framework.项目地址https://gitcode.com/gh_mirrors/or/OrchardCore点击查看免费下载OrchardCore.Email 是 OrchardCore 中负责邮件基础设施的核心模块它通过统一的IEmailProvider抽象与IEmailService门面让一套代码可以同时对接 SMTP、Azure Communication Service 等多个邮件服务商并在运行时自由切换默认 Provider。本文基于src/docs/reference/modules/Email/README.md结合仓库源码与内置 Provider 模块完整讲解邮件设置、Provider 注册与自定义开发、消息发送、事件钩子与 Recipe 配置帮助你在自己的 OrchardCore 应用中快速接入并扩展邮件能力。模块概览为多邮件服务商而生的基础设施OrchardCore.Email模块src/OrchardCore/OrchardCore.Email.Abstractions与src/OrchardCore/OrchardCore.Email.Core提供的不是某个单一的邮件发送实现而是发送邮件所需的基础设施。它的设计目标是用多个可插拔的邮件 Provider 来发送邮件不同 Provider 之间互不干扰调用方无需关心底层协议。整个模块围绕几个核心抽象展开抽象/类型文件位置职责IEmailProviderIEmailProvider.cs邮件 Provider 接口定义DisplayName与SendAsyncIEmailServiceIEmailService.cs面向调用方的邮件发送门面支持指定 ProviderMailMessageMailMessage.cs邮件消息模型收件人、主题、HTML/纯文本正文、附件EmailProviderOptionsEmailProviderOptions.cs已注册 Provider 的只读注册表EmailSettingsEmailSettings.cs站点设置中的默认 Provider 配置DefaultEmailServiceDefaultEmailService.csIEmailService的默认实现负责解析 Provider 并编排事件从发送链路看DefaultEmailService.SendAsync首先通过IEmailProviderResolver解析目标 Provider未指定时使用默认 Provider然后依次触发ValidatingAsync、ValidatedAsync、SendingAsync、SentAsync/FailedAsync等事件最后委托给具体 Provider 完成投递——这一实现细节位于 DefaultEmailService.cs后文事件一节会展开。启用模块与邮件设置页启用OrchardCore.Email功能后后台会在Settings→Communication→Email下新增一个设置页。该设置页用于配置默认邮件 ProviderDefaultProviderName它对应 EmailSettings.cs 中的同名属性并最终映射到 EmailOptions.cs 供服务层读取。这个页面本身并不承载某个 Provider 的连接细节——SMTP 服务器地址、Azure 连接串等敏感配置分别由各自的 Provider 模块管理。OrchardCore 内置了两套 Provider 族共四种形态Provider说明所属功能模块激活方式详细文档SMTP基于 SMTP 协议发送邮件OrchardCore.Email.Smtp在邮件设置页的SMTP标签页中编辑SMTP Provider 文档Default SMTP同样基于 SMTP 协议但通过配置提供程序如appsettings.json、环境变量激活OrchardCore.Email.Smtp使用配置提供程序无需站点设置SMTP Provider 文档Azure Communication Service基于 Azure Communication Services 发送邮件OrchardCore.Email.Azure在邮件设置页的Azure标签页中编辑Azure Provider 文档Default Azure Communication Service同样基于 Azure Communication Services通过配置提供程序激活OrchardCore.Email.Azure使用配置提供程序无需站点设置Azure Provider 文档Default默认前缀的 Provider 面向的场景是不想在后台设置界面填写账号信息而是希望在部署层面通过appsettings.json或环境变量集中管理凭据。两类 Provider 可以在同一个站点中并存再通过DefaultProviderName指定实际使用的那个。注册自定义 Provider两种官方推荐姿势OrchardCore.Email的扩展点非常清晰实现IEmailProvider接口然后把实现注册进EmailProviderOptions注册表。注册方式由 Provider 是否需要配置决定对应 ServiceCollectionExtensions.cs 中的两个扩展方法。方式一无配置的简单 Provider ——AddEmailProvider如果你的 Provider 不需要任何设置例如固定向某个测试端点发送、使用常量凭据的桩实现可以直接用AddEmailProvider注册第一个泛型参数是 Provider 实现类型字符串参数是该 Provider 的技术名称technical name它会被写入EmailProviderOptions注册表并成为IEmailService.SendAsync中providerName参数的取值依据services.AddEmailProviderYourCustomImplemenation(A technical name for your implementation);从源码可以看到AddEmailProviderT内部实际上是services.ConfigureEmailProviderOptions(options { options.TryAddProvider(name, new EmailProviderTypeOptions(typeof(T)) { IsEnabled true, }); });即默认将新 Provider 标记为启用IsEnabled true。EmailProviderTypeOptions会校验类型确实实现了IEmailProvider否则抛出ArgumentException见 EmailProviderTypeOptions.cs。方式二带复杂配置的 Provider ——AddEmailProviderOptionsConfiguration像内置 SMTP 这种需要从SmtpOptions读取服务器、端口、凭据并据此决定是否启用的复杂 Provider更适合实现IConfigureOptionsEmailProviderOptions然后用AddEmailProviderOptionsConfiguration注册services.AddEmailProviderOptionsConfigurationYourCustomImplemenation()以下是官方文档给出的 SMTP Provider 注册示例真实实现见OrchardCore.Email.Smtp模块public class SmtpProviderOptionsConfigurations : IConfigureOptionsEmailProviderOptions { private readonly SmtpOptions _smtpOptions; public SmtpProviderOptionsConfigurations(IOptionsSmtpOptions smtpOptions) { _smtpOptions smtpOptions.Value; } public void Configure(EmailProviderOptions options) { var typeOptions new EmailProviderTypeOptions(typeof(SmtpEmailProvider)) { IsEnabled _smtpOptions.IsEnabled }; options.TryAddProvider(SmtpEmailProvider.TechnicalName, typeOptions); } }这里的关键点在于Provider 的启用状态IsEnabled可以由其 Options 动态决定。当 SMTP 尚未配置完成时IsEnabled为false解析器便不会选中它从而避免发送失败时抛出难懂的协议错误。运行时配置刷新IOptionsMonitor与 Signal 变更令牌文档特别强调了一个进阶场景如果 Provider 的 Options 来自站点设置或其他租户数据、且可能在运行时变化那么在 Provider 以及任何依赖这些 Options 的IConfigureOptionsEmailProviderOptions实现中都应通过IOptionsMonitorTOptions消费配置为参与提交后刷新post-commit refresh的 Options 类型注册AddSignalOptionsChangeTokenSourceTOptions()当设置编辑器保存更改后通过IOptionsUpdateNotifier请求使相关 Options 类型失效。OrchardCore 现在会通过使AzureEmailOptions、EmailProviderOptions和EmailOptions失效来就地刷新Azure 邮件 Provider内置邮件模块为这些 Options 类型注册了基于 Signal 的变更令牌源使标准的IOptionsMonitorTOptions能从已提交的租户状态重建配置。这意味着修改 Azure 连接信息后无需重启租户或重建服务容器配置即可热生效。注册表操作 APIEmailProviderOptionsEmailProviderOptions.cs本身还提供了三个操作注册表的方法供高级场景如按租户动态增删 Provider使用方法行为TryAddProvider(name, options)仅当同名 Provider 不存在时添加已存在则静默返回RemoveProvider(name)移除已注册的 ProviderReplaceProvider(name, options)替换同名 Provider不存在则直接添加Providers属性返回的只读字典以技术名称 →EmailProviderTypeOptions的形式暴露全部已注册 Provider。发送邮件注入IEmailService调用SendAsync向调用方暴露的发送入口是IEmailServiceIEmailService.csTaskResult SendAsync(MailMessage message, string providerName null, CancellationToken cancellationToken default);第二个参数providerName传入 Provider 的技术名称传null或空字符串时使用EmailSettings.DefaultProviderName指定的默认 Provider。官方文档给出的控制器示例保留原文仅修正方法命名以贴合语义public class TestController { private readonly IEmailService _emailService; public TestController(IEmailService emailService) { _emailService emailService; } public async Task SendSmsMessage() { var message new MailMessage { To to-emailtest.com, Subject Subject for the email, Body Body of the email, }; var result await _emailService.SendAsync(message); if (result.Succeeded) { // message was sent! return Ok(result); } return BadRequest(result); } }MailMessage 字段详解MailMessageMailMessage.cs是发送邮件的统一载体结合源码注释整理如下属性类型说明Fromstring发件人地址RFC 822 意义上的作者Tostring收件人地址Ccstring抄送地址Bccstring密送地址ReplyTostring回复地址Senderstring实际提交人若与From不同则必须提供见 RFC 822Subjectstring邮件主题HtmlBodystringHTML 格式正文TextBodystring纯文本格式正文AttachmentsListMailMessageAttachment附件集合初始化器赋值需要注意的兼容性细节旧版的IsHtmlBody与Body属性已标记为[Obsolete]新代码应改用HtmlBody/TextBody分别承载两种格式的正文。也就是说你可以同时提供 HTML 与纯文本两个版本由底层 Provider 决定如何呈现。发送链路内部流程DefaultEmailService.SendAsyncDefaultEmailService.cs的真实执行顺序是通过IEmailProviderResolver.GetAsync(providerName)解析 Provider解析不到时直接返回失败并记录日志Email settings must be configured before an Email message can be sent.构造MailMessageValidationContext触发ValidatingAsync与ValidatedAsync事件默认的校验器是注册为IEmailServiceEvents的EmailMessageValidator校验出错validationContext.Errors.Count 0时触发FailedAsync并返回携带错误明细的失败Result通过校验后触发SendingAsync调用provider.SendAsync(message, cancellationToken)根据 Provider 返回的Result触发SentAsync成功或FailedAsync失败并原样返回结果。这套编排在 ServiceCollectionExtensions.cs 的AddEmailServices中完成依赖装配IEmailService→DefaultEmailService、IEmailProviderResolver→DefaultEmailProviderResolver、IEmailServiceEvents→EmailMessageValidator并注册IConfigureOptionsEmailOptions。测试 Provider内置 Email Test 页面配置好 Provider 后可以通过后台Tools→Testing→Email Test页面直接向指定地址发送一封测试邮件无需写代码即可验证 SMTP 服务器地址、端口、加密方式与凭据是否正确。建议按以下顺序排查确认邮件设置页中默认 Provider 已被选中且处于启用状态在 Email Test 页面填写测试收件人并发送若失败检查返回的Result错误信息通常包含 Provider 层面的连接或认证错误。事件钩子IEmailServiceEvents与EmailServiceEventsBase如果你需要在发送过程中做日志、统计、审计或消息改写可以实现IEmailServiceEvents接口或直接继承EmailServiceEventsBase基类位于 EmailServiceEventsBase.cs然后注册为服务即可。结合DefaultEmailService的调用点事件序列为事件方法触发时机ValidatingAsync(message, context, token)Provider 解析成功后、校验开始前ValidatedAsync(message, context, token)校验完成后无论是否通过均触发SendingAsync(message, token)校验通过后、委托 Provider 发送前SentAsync(message, token)Provider 报告发送成功后FailedAsync(message, token)校验失败或 Provider 报告发送失败时由于DefaultEmailService通过IEnumerableIEmailServiceEvents注入所有事件监听者你可以注册任意多个监听者它们都会被依次调用。Recipe 配置用 Settings 步骤预设邮件设置邮件设置也可以通过 Recipe 的settings步骤在部署时预设无需人工进入后台{ steps: [ { name: settings, EmailSettings: { DefaultProviderName: SMTP } } ] }属性类型说明DefaultProviderNameString默认邮件 Provider 的技术名称这里写入的正是EmailSettings.DefaultProviderName——注意它必须与某个已注册 Provider 的技术名称完全一致例如内置 SMTP Provider 的SmtpEmailProvider.TechnicalName否则发送时解析器将无法找到 Provider。借助 Recipe 与Default SMTP / Default Azure这类由配置驱动的 Provider可以组成代码仓库管默认 Provider、部署配置管连接凭据的完全可复制部署方案。总结一套抽象多种投递通道从模块边界看OrchardCore.Email把邮件是什么MailMessage与邮件怎么发IEmailProvider彻底解耦站点设置决定默认 ProviderIEmailService统一暴露发送入口事件系统让发送过程可观测、可干预Recipe 让配置可版本化。无论你最终选用内置的 SMTP/Azure Provider还是按本文两种方式接入自研 Provider短信网关、第三方邮件 API 等这套基础设施都能在不动业务代码的前提下完成通道切换。赞分享CMS后端Web框架【免费下载链接】OrchardCoreOrchard Core is an open-source modular and multi-tenant application framework built with ASP.NET Core, and a content management system (CMS) built on top of that framework.项目地址https://gitcode.com/gh_mirrors/or/OrchardCore点击查看免费下载相关推荐OpCore-Simplify 完整教程把 OpenCore EFI 生成从几天压到半小时OpCore Simplify 完整教程把 OpenCore EFI 生成从几天压到半小时 昨晚一点你做好 U 盘、重启屏幕只给你一个灰底加角落的红色禁止开发工具CLIWasp 邮件发送的 Dummy Provider开发环境的控制台邮件模拟器与生产构建红线Wasp 邮件发送的 Dummy Provider开发环境的控制台邮件模拟器与生产构建红线 Wasp 是面向 AI 时代的开箱即用全栈框架其内建的邮件发Web框架后端前端CLI开发工具Yii 2 邮件发送完全指南从 mailer 组件配置到自定义邮件解决方案Yii 2 邮件发送完全指南从 mailer 组件配置到自定义邮件解决方案 本文围绕 Yii 2 官方指南中的邮件发送Mailing主题展开系统讲解后端Web框架上一篇5步精通MagiskBootAndroid启动镜像处理的完整实战指南下一篇MagiskBoot实战指南掌握Android启动镜像处理的7个核心技巧创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
