Erweiterung der Funktionen der Drupal 8 Mail API: Teil 1

In dieser zweiteiligen Serie erkunden wir die Mail-API in Drupal 8. Dabei werden wir zwei Hauptaspekte behandeln: wie man es programmgesteuert zum Versenden von E-Mails nutzt und wie man es erweitert, um externe Dienste wie Mandrill zu nutzen.

Um dies zu demonstrieren, erstellen wir im ersten Teil eine benutzerdefinierte E-Mail-Vorlage, die eine E-Mail an den aktuellen Benutzer sendet, wenn er/sie einen neuen Artikelknoten speichert. Darüber hinaus schauen wir uns an, wie andere diese Vorlage geändert haben, damit HTML den E-Mail-Text anstelle des standardmäßigen Nur-Texts rendern kann.

Im zweiten Teil befassen wir uns mit der Erweiterung des Mailsystems und der Integration externer APIs für den E-Mail-Versand. Hierzu verwenden wir Mandrill und seine PHP-Bibliothek, die eine gute Grundlage für die Interaktion mit seiner API bietet.

Alle von uns geleisteten Arbeiten finden Sie in diesem Git-Repository als Teil des benutzerdefinierten Drupal 8-Moduls, mit dessen Beschreibung wir hier beginnen. Wenn Sie also mitmachen möchten, schauen Sie sich das gerne an. Fangen wir an.

Die erste Voraussetzung für dieses Modul ist seine .info-Datei:

d8mail.info.yml:

name: Drupal 8 Mailer
description: 'Demonstrates the use of the Mail API in Drupal 8.'
core: 8.x
type: module

Nachdem dieses Problem behoben ist, können wir das Modul bei Bedarf auf unserer Website aktivieren.

Wie versenden wir E-Mails?

Das programmgesteuerte Versenden von E-Mails mit Drupal 8 erfordert zwei Hauptschritte. Zuerst müssen wir Hook_mail() implementieren, um eine oder mehrere E-Mail-Vorlagen zu definieren. Der zweite Schritt besteht darin, Ihren E-Mail-Manager zu verwenden, um eine E-Mail mit einer dieser Vorlagen zu senden.

Obwohl ein Hook genannt, hook_mail() 并不是典型的钩子，而是更多的常规函数​​，通常仅由实现它的同一模块调用。换句话说，当您以编程方式发送电子邮件时，您需要指定实现 hook_mail() der Name des Moduls und die Vorlagen-ID, die Sie verwenden möchten und die durch diesen Hook definiert werden. Aber das werden wir bald sehen. Erstens: Wie setzen wir es um?

d8mail.module:

/**
 * Implements hook_mail().
 */
function d8mail_mail($key, &$message, $params) {
  $options = array(
    'langcode' => $message['langcode'],
  );

  switch ($key) {
    case 'node_insert':
      $message['from'] = \Drupal::config('system.site')->get('mail');
      $message['subject'] = t('Node created: @title', array('@title' => $params['node_title']), $options);
      $message['body'][] = SafeMarkup::checkPlain($params['message']);
      break;
  }
}

Dies ist eine sehr einfache Implementierung, die eine

Vorlagenode_insert （$key definiert, die als gekennzeichnet ist. Die anderen beiden Funktionsparameter sind:

• : Pass by reference, wobei wir so viele Textbausteine ​​zur E-Mail hinzufügen, wie wir benötigen $message
• : Array zusätzlicher Daten, die in die E-Mail eingefügt werden müssen und vom E-Mail-Manager übergeben werden, wenn wir versuchen, die E-Mail zu senden $params

Wie Sie sehen können, erstellen wir ein

-Array mit den Werten, die diese E-Mail in alle Anrufe einbeziehen soll. Wir legen einen Standardwert für from fest, der vom Konfigurationssystem abgerufen wird und die E-Mail-Adresse der Hauptseite darstellt. Wir richten einen Standard-E-Mail-Betreff ein, der den Empfänger darüber informiert, dass ein neuer Knoten erstellt wurde, gefolgt vom Namen des Knotens (der über das $message 数组，其中包含我们希望此电子邮件包含在所有调用中的值。我们正在设置一个默认的 from 值，该值从配置系统检索并代表主站点电子邮件地址。我们设置一个样板电子邮件 subject ，让收件人知道创建了一个新节点，后跟节点的名称（将通过 $params-Array übergeben wird). Das Thema kann auch in die vom Anrufer übermittelte Sprache übersetzt werden.

Schließlich führen wir die Nachricht durch die String-Desinfektionsklasse body，因为文本可能包含 HTML，如果我们不对 HTML 元素进行编码，它可能会被截断。由于我们使用的是 SafeMarkup, also müssen wir sie oben verwenden :

use Drupal\Component\Utility\SafeMarkup;

Außerdem ist der Nachrichtentext ein Array, das später in einen String

implodiert wird. Natürlich gibt es noch viele andere Parameter, die wir festlegen können, z. B. Header, aber das reicht für dieses Beispiel aus.

Darum geht es bei

. Schauen wir uns nun den Code an, der jedes Mal ausgeführt wird, wenn ein neuer Knoten erstellt wird: Hook_entity_insert(): hook_mail()

/**
 * Implements hook_entity_insert().
 */
function d8mail_entity_insert(Drupal\Core\Entity\EntityInterface $entity) {

  if ($entity->getEntityTypeId() !== 'node' || ($entity->getEntityTypeId() === 'node' && $entity->bundle() !== 'article')) {
    return;
  }

  $mailManager = \Drupal::service('plugin.manager.mail');

  $module = 'd8mail';
  $key = 'node_insert';
  $to = \Drupal::currentUser()->getEmail();
  $params['message'] = $entity->get('body')->value;
  $params['node_title'] = $entity->label();
  $langcode = \Drupal::currentUser()->getPreferredLangcode();
  $send = true;

  $result = $mailManager->mail($module, $key, $to, $langcode, $params, NULL, $send);
  if ($result['result'] !== true) {
    $message = t('There was a problem sending your email notification to @email for creating node @id.', array('@email' => $to, '@id' => $entity->id()));
    drupal_set_message($message, 'error');
    \Drupal::logger('d8mail')->error($message);
    return;
  }

  $message = t('An email notification has been sent to @email for creating node @id.', array('@email' => $to, '@id' => $entity->id()));
  drupal_set_message($message);
  \Drupal::logger('d8mail')->notice($message);
}

Dieser Hook wird nach jedem Knotenspeichern ausgelöst. Wir müssen lediglich sicherstellen, dass wir den richtigen Knoten anvisieren und unsere Logik einbinden.

Nachdem wir überprüft haben, ob die Knotenentität vom Typ

ist, laden wir den Drupal Mail Manager-Dienst und beginnen mit dem Festlegen einiger Werte für die E-Mail. Wir benötigen folgende Informationen: article

• 实现 hook_mail() 并定义我们的模板（我上面提到的）的模块名称
• 模板 ID（$key）
• 收件人电子邮件地址（在当前用户帐户中找到的地址）
• 进入 $params 数组并用于翻译主题消息的语言 ($langcode)
• 将添加到电子邮件主题的节点标题
• 电子邮件正文，在我们的例子中将是节点正文字段的值
• 指示是否应实际发送电子邮件的布尔值

然后我们将所有这些值传递给邮件管理器的 mail() 方法。后者负责构建电子邮件（调用正确的 hook_mail() 实现是其中的一方面）并最终将实际交付委托给负责的插件。默认情况下，这将是 PHPMail，它使用 PHP 自带的默认 mail() 函数。

如果邮件管理器成功发送电子邮件（不考虑实际发送，而是考虑成功的 PHP 操作），则 mail() 方法将返回一个包含 result 键的数组，其中包含以下内容：邮件插件返回。通过检查该值，我们可以了解电子邮件操作是否成功，并通知用户我们已通知他们他们的操作。否则，我们将打印并记录一条错误消息。

就是这样。清除缓存并创建文章节点应该会在您的收件箱中收到一封电子邮件。如果您没有收到任何信息，并且屏幕上没有错误迹象，请务必检查服务器日志和邮件队列，以验证电子邮件是否已发出。

在继续之前，我想快速说明一下这个钩子的实现。在这个例子中，我直接将所有逻辑放在其中。此外，我在顶部使用了早期返回，这本质上意味着除了特定于文章节点的逻辑之外，不能添加其他逻辑。在实际应用程序中，我建议将邮件逻辑重构为单独的函数或类，并遵循该逻辑。此外，您不应在钩子实现中使用提前返回，而应在满足条件时调用其他函数。

我们如何更改电子邮件？

一旦所有这些都到位，我们就可以使用另一个工具来更改现有的设置：hook_mail_alter()。在负责的邮件插件发送电子邮件之前，从邮件管理器内部调用此挂钩。目的是允许其他模块对正在发送的现有电子邮件进行最终更改。

虽然其他模块也可以使用它，但我们将在我们一直使用的同一模块中说明示例实现。为此，我们将通过更改其默认标头之一来更改电子邮件，以便将其从纯文本转换为 HTML。我们可以这样做：

/**
 * Implements hook_mail_alter().
 */
function d8mail_mail_alter(&$message) {
  switch ($message['key']) {
    case 'node_insert':
      $message['headers']['Content-Type'] = 'text/html; charset=UTF-8; format=flowed; delsp=yes';
      break;
  }
}

如您所见，这是对 Content-Type 标头的简单更改，可将电子邮件转换为 HTML。这样纯文本 HTML 实体将被邮件客户端解析为 HTML。使用 switch case，我们确保这只发生在我们之前定义的电子邮件模板中。

这里需要注意的一件事是，在相关的 hook_mail() 实现之后调用 alter hook。因此，在此之后，对电子邮件进行的唯一处理是在邮件插件的 format() 方法内完成的（由其接口强制执行）。

结论

这几乎就是使用 Drupal 8 以编程方式发送电子邮件的全部内容。我们已经了解了以编程方式设置电子邮件模板所需的步骤，只要我们需要，这些模板就会由邮件管理器进行水合。我们还提到了 Drupal 8 中用于发送电子邮件的默认邮件传递插件。最后，我们看到了其他模块现在如何通过添加新标头、更改主题、将值连接到邮件正文来更改我们的电子邮件等

在下一篇文章中，我们将考虑用我们自己的自定义实现替换默认的 PHPMail 插件。我们将在 PHP 库的帮助下设置一个使用 Mandrill 的邮件程序。目标是允许我们自己的模块使用此邮件程序，而应用程序的其余部分继续使用默认的 PHPMailer。

Das obige ist der detaillierte Inhalt vonErweiterung der Funktionen der Drupal 8 Mail API: Teil 1. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!