interface MailInterface in Zircon Profile 8
Same name and namespace in other branches
- 8.0 core/lib/Drupal/Core/Mail/MailInterface.php \Drupal\Core\Mail\MailInterface
Defines an interface for pluggable mail back-ends.
Hierarchy
- interface \Drupal\Core\Mail\MailInterface
Expanded class hierarchy of MailInterface
All classes that implement MailInterface
See also
3 files declare their use of MailInterface
- PhpMail.php in core/
lib/ Drupal/ Core/ Mail/ Plugin/ Mail/ PhpMail.php - Contains \Drupal\Core\Mail\Plugin\Mail\PhpMail.
- TestMailCollector.php in core/
lib/ Drupal/ Core/ Mail/ Plugin/ Mail/ TestMailCollector.php - Contains \Drupal\Core\Mail\Plugin\Mail\TestMailCollector.
- TestPhpMailFailure.php in core/
modules/ system/ tests/ modules/ system_mail_failure_test/ src/ Plugin/ Mail/ TestPhpMailFailure.php - Contains \Drupal\system_mail_failure_test\Plugin\Mail\TestPhpMailFailure.
File
- core/
lib/ Drupal/ Core/ Mail/ MailInterface.php, line 17 - Contains \Drupal\Core\Mail\MailInterface.
Namespace
Drupal\Core\MailView source
interface MailInterface {
/**
* Formats a message prior to sending.
*
* Allows to preprocess, format, and postprocess a mail message before it is
* passed to the sending system. By default, all messages may contain HTML and
* are converted to plain-text by the Drupal\Core\Mail\Plugin\Mail\PhpMail
* implementation. For example, an alternative implementation could override
* the default implementation and also sanitize the HTML for usage in a MIME-
* encoded email, but still invoking the Drupal\Core\Mail\Plugin\Mail\PhpMail
* implementation to generate an alternate plain-text version for sending.
*
* @param array $message
* A message array, as described in hook_mail_alter().
*
* @return array
* The formatted $message.
*
* @see \Drupal\Core\Mail\MailManagerInterface
*/
public function format(array $message);
/**
* Sends a message composed by \Drupal\Core\Mail\MailManagerInterface->mail().
*
* @param array $message
* Message array with at least the following elements:
* - id: A unique identifier of the email type. Examples: 'contact_user_copy',
* 'user_password_reset'.
* - to: The mail address or addresses where the message will be sent to.
* The formatting of this string will be validated with the
* @link http://php.net/manual/filter.filters.validate.php PHP email validation filter. @endlink
* Some examples:
* - user@example.com
* - user@example.com, anotheruser@example.com
* - User <user@example.com>
* - User <user@example.com>, Another User <anotheruser@example.com>
* - subject: Subject of the email to be sent. This must not contain any
* newline characters, or the mail may not be sent properly. The subject
* is converted to plain text by the mail plugin manager.
* - body: Message to be sent. Accepts both CRLF and LF line-endings.
* Email bodies must be wrapped. For smart plain text wrapping you can use
* \Drupal\Core\Mail\MailFormatHelper::wrapMail() .
* - headers: Associative array containing all additional mail headers not
* defined by one of the other parameters. PHP's mail() looks for Cc and
* Bcc headers and sends the mail to addresses in these headers too.
*
* @return bool
* TRUE if the mail was successfully accepted for delivery, otherwise FALSE.
*/
public function mail(array $message);
}
Members
Name | Modifiers | Type | Description | Overrides |
---|---|---|---|---|
MailInterface:: |
public | function | Formats a message prior to sending. | 1 |
MailInterface:: |
public | function | Sends a message composed by \Drupal\Core\Mail\MailManagerInterface->mail(). | 1 |