function MailSystemInterface::mail
Send a message composed by drupal_mail().
Parameters
$message: Message array with at least the following elements:
- id: A unique identifier of the e-mail 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
PHP e-mail validation filter.
Some examples are:
- 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 e-mail to be sent. This must not contain any newline characters, or the mail may not be sent properly.
- body: Message to be sent. Accepts both CRLF and LF line-endings. E-mail bodies must be wrapped. You can use drupal_wrap_mail() for smart plain text wrapping.
- 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 value
TRUE if the mail was successfully accepted for delivery, otherwise FALSE.
2 methods override MailSystemInterface::mail()
- DefaultMailSystem::mail in modules/
system/ system.mail.inc - Send an e-mail message, using Drupal variables and default settings.
- MailTestCase::mail in modules/
simpletest/ tests/ mail.test - Send function that is called through the mail system.
File
-
includes/
mail.inc, line 342
Class
- MailSystemInterface
- An interface for pluggable mail back-ends.
Code
public function mail(array $message);
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.