class TestMailCollector

Same name in other branches
  1. 8.9.x core/lib/Drupal/Core/Mail/Plugin/Mail/TestMailCollector.php \Drupal\Core\Mail\Plugin\Mail\TestMailCollector
  2. 10 core/lib/Drupal/Core/Mail/Plugin/Mail/TestMailCollector.php \Drupal\Core\Mail\Plugin\Mail\TestMailCollector
  3. 11.x core/lib/Drupal/Core/Mail/Plugin/Mail/TestMailCollector.php \Drupal\Core\Mail\Plugin\Mail\TestMailCollector

Defines a mail backend that captures sent messages in the state system.

This class is for running tests or for development.

Plugin annotation


@Mail(
  id = "test_mail_collector",
  label = @Translation("Mail collector"),
  description = @Translation("Does not send the message, but stores it in Drupal within the state system. Used for testing.")
)

Hierarchy

Expanded class hierarchy of TestMailCollector

2 files declare their use of TestMailCollector
MailTest.php in core/modules/system/tests/src/Kernel/Mail/MailTest.php
TestHtmlMailCollector.php in core/modules/system/tests/modules/mail_html_test/src/Plugin/Mail/TestHtmlMailCollector.php

File

core/lib/Drupal/Core/Mail/Plugin/Mail/TestMailCollector.php, line 18

Namespace

Drupal\Core\Mail\Plugin\Mail
View source
class TestMailCollector extends PhpMail implements MailInterface {
    
    /**
     * {@inheritdoc}
     */
    public function mail(array $message) {
        $captured_emails = \Drupal::state()->get('system.test_mail_collector', []);
        $captured_emails[] = $message;
        \Drupal::state()->set('system.test_mail_collector', $captured_emails);
        return TRUE;
    }

}

Members

Title Sort descending Modifiers Object type Summary Overriden Title Overrides
PhpMail::$configFactory protected property The configuration factory.
PhpMail::doMail protected function Wrapper around PHP's mail() function.
PhpMail::format public function Concatenates and wraps the email body for plain-text mails. Overrides MailInterface::format 1
PhpMail::MAILBOX_LIST_HEADERS private constant A list of headers that can contain multiple email addresses.
PhpMail::_isShellSafe protected static function Disallows potentially unsafe shell characters.
PhpMail::__construct public function PhpMail constructor.
TestMailCollector::mail public function Sends an email message. Overrides PhpMail::mail

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.