bitrix-mail

Bitrix 邮件

基线：main 23.0+ · 已验证：main 26.800.0

任务	阅读
事件类型、模板、#FIELD# 宏、HTML 转义	rules/templates.md
发送（加入队列或立即发送）、附件、Mail::sendResult()、发件人身份、SMTP 选择	rules/sending.md
钩子、队列处理与 cron、测试、投递诊断	rules/hooks-testing.md

SMTP 服务器和 .settings.php 中的 smtp 部分：bitrix-settings。迁移中的类型和模板：bitrix-sprint-migration。

不可变规则

• 通过邮件事件发送，并使用管理员可编辑的模板（Mail\Event::send()）；仅在没有合适模板时，才用 Mail::sendResult() 构造原始邮件。
• 队列（b_event）是默认方式；它会在请求处理后或由 cron 清空。仅当调用方需要立即获得结果时，才使用 sendImmediate()。
• C_FIELDS 的值必须是字符串或字符串数组。队列会通过 __toString() 将对象存储为 (string)，若对象没有该方法，则存储为 ''。
• 在 HTML 模板中，将用户数据输出为 #HTML_FIELD#；#FIELD# 会原样插入。
• 对所有来自用户输入的地址进行验证（check_email()），确保在地址进入用于 EMAIL_TO、CC 或邮件头的字段前完成验证。
• 模板必须绑定到站点：使用 CEventMessage 创建，而不是 EventMessageTable::add()。