Сопряжение битриксовых событий и транспорта email.

Author: ProklUng

lib/Bitrix/BitrixMailEventSender.php

@@ -0,0 +1,76 @@
+<?php
+
+namespace Proklung\Notifier\Bitrix;
+
+use Bitrix\Main\ArgumentException;
+use Bitrix\Main\ObjectPropertyException;
+use Bitrix\Main\SystemException;
+use Symfony\Component\Notifier\Notification\Notification;
+use Symfony\Component\Notifier\NotifierInterface;
+use Symfony\Component\Notifier\Recipient\Recipient;
+
+/**
+ * Class BitrixMailEventSender
+ * @package Proklung\Notifier\Bitrix
+ *
+ * @since 28.07.2021
+ */
+class BitrixMailEventSender
+{
+    /**
+     * @var EventBridge $eventBridge Обработка битриксовых данных события.
+     */
+    private $eventBridge;
+
+    /**
+     * @var NotifierInterface $notifier Notifier.
+     */
+    private $notifier;
+
+    /**
+     * BitrixMailEventSender constructor.
+     *
+     * @param EventBridge       $eventBridge Обработка битриксовых данных события.
+     * @param NotifierInterface $notifier    Notifier.
+     */
+    public function __construct(EventBridge $eventBridge, NotifierInterface $notifier)
+    {
+        $this->eventBridge = $eventBridge;
+        $this->notifier = $notifier;
+    }
+
+    /**
+     * Статический фасад.
+     *
+     * @param NotifierInterface $notifier Notifier.
+     *
+     * @return static
+     */
+    public static function getInstance(NotifierInterface $notifier) : self
+    {
+        return new static(new EventBridge(), $notifier);
+    }
+
+    /**
+     * @param string $codeEvent Код события.
+     * @param array  $arFields  Параметры события.
+     *
+     * @return void
+     * @throws ArgumentException | ObjectPropertyException | SystemException Битриксовые ошибки.
+     */
+    public function send(string $codeEvent, array $arFields) : void
+    {
+        $eventsInfo = $this->eventBridge->getMessageTemplate($codeEvent);
+        foreach ($eventsInfo as $eventInfo) {
+            $compileData = $this->eventBridge->compileMessage($eventInfo, $arFields, ['s1']);
+
+            $notification = (new Notification($compileData['subject']))
+                ->content($compileData['body'])
+                ->importance(Notification::IMPORTANCE_MEDIUM);
+
+            $recipient = new Recipient($compileData['mail_to']);
+
+            $this->notifier->send($notification, $recipient);
+        }
+    }
+}

lib/Bitrix/EventBridge.php

@@ -24,9 +24,9 @@ class EventBridge
      * @param array     $context   Значения полей ($arFields).
      * @param array     $sites     ID сайтов.
      *
-     * @return mixed
+     * @return array
      */
-    public function compileMessage(EventInfo $eventInfo, array $context, array $sites = [])
+    public function compileMessage(EventInfo $eventInfo, array $context, array $sites = []) : array
     {
         $message = EventMessageCompiler::createInstance([
             'EVENT' => $eventInfo->getEventCode(),
@@ -37,7 +37,11 @@ public function compileMessage(EventInfo $eventInfo, array $context, array $site
         ]);
         $message->compile();
 
-        return $message->getMailBody();
+        return ['body' => $message->getMailBody(),
+            'mail_to' => $message->getMailTo(),
+            'charset' => $message->getMailCharset(),
+            'subject' => $message->getMailSubject(),
+        ];
     }
 
     /**
@@ -48,7 +52,7 @@ public function compileMessage(EventInfo $eventInfo, array $context, array $site
      *
      * @throws ArgumentException | ObjectPropertyException | SystemException Битриксовые ошибки.
      */
-    public function getMessageTemplate(string $codeEvent, array $sites = [])
+    public function getMessageTemplate(string $codeEvent, array $sites = []) : array
     {
         $arSites = ['s1'];
         if (count($sites) > 0) {

readme.MD

@@ -179,9 +179,25 @@ return [
 
 ## Прочее
 
-#### FlashBag
+### FlashBag
 
 Для обработки отправок в канал `browser`. Два варианта:
 
 - публичный сервис `session_instance` вернет экземпляр сессии, а там есть метод `getFlashBag`.
 - хэлпер `\Proklung\Notifier\DI\Services::getFlashBag()`, делающий тоже самое.
+
+### Использование битриксовых почтовых событий и их шаблонов
+
+```php
+        use Proklung\Notifier\Bitrix\BitrixMailEventSender;
+
+        $bitrixEventHandler = BitrixMailEventSender::getInstance(
+            \Proklung\Notifier\DI\Services::getInstance()->get('notifier')
+        );
+
+        // Массив, идентичный с параметром fields при отправке Битриксом сообщений
+        // См. https://dev.1c-bitrix.ru/api_help/main/reference/cevent/send.php 
+        $arFields = ['NAME' => 'testing email', 'EMAIL' => 'recipitient@gmail.com'];
+
+        $bitrixEventHandler->send('CODE_MAIL_EVENT', $arFields);
+```