用途:整理 Bitrix 中邮件事件与模板的使用规范,覆盖事件类型与模板(CEventType、CEventMessage)、#FIELD# 宏、HTML 转义规则,以及发送(队列或即时)、附件、Mail::sendResult()、发件人身份与 SMTP 选择;还包括钩子、队列处理与 cron、测试和投递诊断。基线 main 23.0+,验证版本 main 26.800.0。
主要能力与规则:应通过带可由后台编辑模板的邮件事件发送,即 Mail\Event::send();仅当没有合适模板时,才用 Mail::sendResult() 构建原始消息。b_event 队列是默认方式,会在命中后或经 cron 排空;只有调用方需要立即拿到结果时才用 sendImmediate()。C_FIELDS 的值为字符串或字符串数组;队列存储对象时通过 __toString() 转成字符串,没有该方法则为空字符串。HTML 模板中输出用户数据用 #HTML_FIELD#,而 #FIELD# 会原样插入。来自用户输入的每个地址在进入 EMAIL_TO、CC 或头部字段使用的字段前,都须用 check_email() 校验。模板必须绑定到站点,需用 CEventMessage 创建,而非 EventMessageTable::add()。
使用方式:按用途查阅 rules/templates.md(事件类型、模板、宏、转义)、rules/sending.md(发送、附件、sendResult、发件人、SMTP)、rules/hooks-testing.md(钩子、队列与 cron、测试、诊断)。SMTP 服务器与 .settings.php 的 smtp 段参见 bitrix-settings;迁移中的类型与模板参见 bitrix-sprint-migration。
限制:上述内容为规范与基线说明,具体配置、收费、平台与效果资料暂未提供。