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# はそのまま挿入されます。
• ユーザー入力に由来するすべてのアドレスを、EMAIL_TO、CC、またはヘッダーで使われるフィールドに渡す前に検証します（check_email()）。
• テンプレートはサイトに紐付ける必要があります。EventMessageTable::add() ではなく、CEventMessage で作成します。